TL;DR

이 저장소는 OpenAI Codex에서 호출하는 repository health audit Skill이며, 독립 실행 가능한 Python CLI와 GitHub Actions composite Action을 함께 제공하는 개발자 도구입니다. 프로젝트 의존성 없이 Git 상태, 빌드와 의존성 설정, 테스트와 CI, 보안 위생, 문서와 ownership, 컨테이너와 대형 파일을 읽기 전용으로 수집하고 Markdown 또는 JSON 보고서로 출력합니다. 두 JSON snapshot을 설정과 범위 정보까지 포함해 비교하므로 새 민감 파일명이나 사라진 테스트처럼 확인할 가치가 높은 변화를 재현 가능한 방식으로 추적할 수 있습니다. 다만 collector 자체가 취약점이나 기술 부채를 확정하지 않고 신호만 모으므로, 최종 우선순위 판단에는 Codex의 추가 검증이나 개발자의 코드 검토가 필요합니다.

핵심 포인트

• 이 저장소는 OpenAI Codex 생태계에서 사용하는 repository health audit Skill입니다. 별도의 Python 표준 라이브러리 도구와 GitHub Actions composite Action도 함께 제공합니다. Codex에서 저장소의 테스트, CI, 보안 신호와 기술 부채를 읽기 전용으로 점검할 때 적합합니다.
• Python 3.10 이상에서 프로젝트 의존성 설치 없이 저장소 신호를 Markdown 또는 JSON으로 수집합니다. Git 상태, manifest, lockfile, 테스트, CI, ownership, container, 대형 파일과 민감해 보이는 파일명을 스캔합니다. 수집 결과는 자동 판정이 아니라 Codex가 근거를 확인할 대상 목록으로 사용됩니다.
• JSON snapshot은 scan mode, 경로 범위, 파일 제한, 스캔 완전성과 전체 대형 파일 목록을 보존합니다. comparer는 두 snapshot의 설정을 고려해 새 민감 파일명, 사라진 CI나 테스트, 새 대형 파일 같은 변화를 찾습니다. --fail-on-attention과 --require-comparable을 켜면 중요한 변화나 비교 불가 baseline을 자동화 작업의 실패 조건으로 연결할 수 있습니다.
• Codex Skill 설치 외에도 CLI와 GitHub Actions에서 동일한 감사 흐름을 실행할 수 있습니다. filesystem, git-visible, tracked 모드와 monorepo 경로 범위, 제외 규칙, 대형 파일 임계값을 선택할 수 있습니다. 반복 가능한 release 검증이나 저장소 건강 상태의 기준선 비교가 필요한 팀에 특히 유용합니다.