Repository Inspector

これは、Git リポジトリの変更を検査し、オプションの検証コマンドを実行して、Markdown レポートを生成する小さな TypeScript 製開発者ツールです。コマンドラインから使用することも、MCP を通じて AI クライアントに公開することもできます。

あなたのタスク

リポジトリを調査し、最善と判断する形で改善してください。スターターは狭いハッピーパスでしか動作しませんが、本番で使用すると、正確性、安全性、信頼性、契約、出力、ドキュメント、テストの弱点が表面化する可能性があります。

すべてを完了する必要はありません。私たちが重視するのは、どのように調査し、優先順位を決め、実装し、検証し、意味のある範囲を説明するかです。

Related MCP server: repository-inspector

プロダクトの決定

このツールは、開発者が直接使用することも、AI コーディングエージェントが使用することもあります。本番インターフェースが CLI ファースト、MCP ファースト、ハイブリッド のいずれであるべきかを判断し、その決定に沿った改善を実装してください。

推奨されるラベルはありません。以下を説明してください：

• 想定した主要ユーザーと実行環境。

• 信頼境界と許可される機能。

• 信頼性、発見可能性、レイテンシ/コンテキスト、出力サイズのトレードオフ。

• 引き続き提供するインターフェースが、どのように動作的一貫性を保つか。

• どのような証拠があれば決定を変えるか。

時間とルール

• 招待を受け取ってから48時間以内に、集中した 90分間 を上限とする。

• AI コーディングツールを自由に使用してください。その作業を検証し、修正または却下した提案を少なくとも1つ文書化してください。

• このテンプレートから作成した自身のリポジトリで作業してください。

• 作業しながらコミットし、最終コミットで SUBMISSION.md を完成させてください。

• 完了は必須ではありません。正確な範囲と検証が、大きな差分よりも重要です。

セットアップ

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 を参照してください。メールでの返信はしないでください。その提出チャネルは監視されていません。