Repository Inspector

이것은 Git 저장소의 변경 사항을 검사하고, 선택적 검증 명령을 실행하며, Markdown 보고서를 생성하는 작은 TypeScript 개발자 도구입니다. 명령줄에서 사용하거나 MCP를 통해 AI 클라이언트에 노출할 수 있습니다.

당신의 작업

저장소를 조사하고 판단에 따라 개선하십시오. 스타터는 좁은 해피 패스에서만 작동하지만, 프로덕션 사용 시 정확성, 안전성, 신뢰성, 계약, 출력, 문서화 또는 테스트 약점이 드러날 수 있습니다.

모든 것을 완료할 필요는 없습니다. 우리는 어떻게 조사하고, 우선순위를 정하고, 구현하고, 검증하고, 의미 있는 범위를 설명하는지에 관심이 있습니다.

Related MCP server: repository-inspector

제품 결정

이 도구는 개발자와 AI 코딩 에이전트가 직접 사용할 수 있습니다. 프로덕션 인터페이스가 CLI 우선, MCP 우선, 또는 하이브리드여야 하는지 결정하십시오. 결정과 일치하는 개선 사항을 구현하십시오.

선호되는 라벨은 없습니다. 다음을 설명하십시오:

• 가정한 기본 사용자와 실행 환경.

• 신뢰 경계와 허용된 기능.

• 신뢰성, 발견 가능성, 지연 시간/컨텍스트, 출력 크기 간의 트레이드오프.

• 계속 광고하는 인터페이스가 동작상 일관성을 유지하는 방법.

• 결정을 바꿀 증거.

시간 및 규칙

• 초대 수신 후 48시간 이내에 최대 90분 집중 작업.

• AI 코딩 도구를 자유롭게 사용하십시오. 그들의 작업을 검증하고 수정하거나 거부한 제안을 최소 하나 문서화하십시오.

• 이 템플릿에서 생성한 자신의 저장소에서 작업하십시오.

• 작업하면서 커밋하고 최종 커밋에서 SUBMISSION.md를 완성하십시오.

• 완료는 필수가 아닙니다. 정확한 범위와 검증이 큰 diff보다 더 중요합니다.

설정

npm install
npm run typecheck
npm test

CLI

npm run inspector -- review --repo ./path/to/repo --format markdown
npm run inspector -- review --repo ./path/to/repo --validate "npm test"

보고서는 review-report.md에 작성됩니다.

MCP

stdio 서버를 다음으로 시작하십시오:

npm run mcp-server

review_repository 도구를 노출하며, repo_path(필수), base_ref(선택), validation_commands(선택적 셸 명령 배열)를 받습니다.

MCP 인수는 검토 중인 저장소 내부의 콘텐츠(프롬프트 인젝션)에 의해 조종될 수 있으므로, MCP를 통한 검증 명령 실행은 기본적으로 비활성화되어 있습니다. 활성화하려면 서버 운영자가 다음 두 환경 변수를 모두 설정해야 합니다 — 하나만 설정하면 검증이 비활성화된 상태로 유지됩니다:

• INSPECTOR_ALLOW_VALIDATION=1

• INSPECTOR_VALIDATION_ALLOWLIST="npm test,npm run typecheck" — 실행이 허용된 정확한 명령의 쉼표로 구분된 목록; 그 외의 것은 건너뜁니다.

검증이 비활성화되거나 명령이 허용 목록에 없으면, 도구는 여전히 전체 읽기 전용 보고서를 반환합니다. 건너뛴 명령은 조용히 버려지는 대신 status: skipped와 이유와 함께 보고됩니다.

프로젝트 구조

src/core.ts         shared review orchestration
src/cli.ts          command-line adapter
src/mcp-server.ts   MCP adapter
src/git.ts          Git inspection
src/validation.ts   validation execution
src/report.ts       Markdown report generation
test/               public starter tests

완료되면 이 저장소의 Security → Report a vulnerability를 통해 제출하십시오 — 포함할 내용은 SECURITY.md를 참조하십시오. 이메일로 답변하지 마십시오. 해당 제출 채널은 모니터링되지 않습니다.