mcpField
R
repo-audit

repo-audit

github.com/paulnsorensen開発063 回インストール1 週間前に更新
リポジトリ

repo-audit について

repo-audit は、適用できるカタログスキルと実行順を調べる読み取り専用のリポジトリ監査スキルです。結果の整理と担当スキルへの振り分けのみを行い、ファイル編集や変更系 API 呼び出しは行いません。

主な機能

  1. 01リポジトリのファイルと設定を検査
  2. 02各カタログスキルの状態を報告
  3. 03JSON と Markdown で結果を出力
  4. 04任意で GitHub リポジトリ設定を参照
  5. 05依存関係に沿って後続作業を整理

活用シーン

  1. 01不足しているリポジトリ保守チェックを把握
  2. 02カタログスキルの実行順を決定
  3. 03スクリプトや PR コメント用の監査結果を作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/paulnsorensen/git-gouda --skill repo-audit

インストール後、Claude Code で/repo-auditを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
evals.json
references/
checks.md
scripts/
repo_audit.py

詳細

repo-audit

リポジトリを、カタログ内のほかのすべてのスキルのセットアップチェックと照らし合わせて読み取り専用で調査します。答えるのは、「ここで適用できるカタログスキルはどれで、どの順番で実施するか」という1つの質問です。

このスキルの対象外

  • 修正の適用 — 指摘事項は、それを担当するスキル（oss-hygiene、gh-bootstrap など）に引き継ぎます。このスキルがファイルを編集したり、変更を伴うAPIを呼び出したりすることはありません。
  • アプリケーションのロジック、テスト、ビジネス上の動作のコードレビュー — 対象外です。
  • カタログスキル独自の手順の置き換え — この監査はトリアージのための確認であり、そのスキルのSKILL.mdを読む代わりにはなりません。

手順

1. リポジトリのルートから同梱スクリプトを実行する
python3 skills/repo-audit/scripts/repo_audit.py

読み取り専用のgh api GET呼び出し（マージ設定、ルールセット、delete_branch_on_merge、CODEOWNERSのエンドポイント）も実行するには、--githubを追加します。--githubはオプトインです。デフォルトの実行では、作業ツリーとローカルのgitメタデータ（git tag --list、git remote get-url origin）のみを読み取ります。

機械処理には--jsonを、PRコメントに表を貼り付けるには--markdownを使用します。スクリプト自体にエラーが発生しない限り、終了コードは常に0です。missingまたはwarnの行があっても、スクリプトの失敗を意味しません。

2. スクリプトはカタログ内のスキルごとに1行ずつ、読み取り専用でチェックする
チェック調査対象引き継ぎ先
prekprek.tomlまたは.pre-commit-config.yamlprek
oss-hygieneLICENSE、CODE_OF_CONDUCT.md、CONTRIBUTING.md、SECURITY.md、.github/ISSUE_TEMPLATE、PULL_REQUEST_TEMPLATE、.github/dependabot.yml、およびscorecard／codeql／dependency-reviewワークフローの有無oss-hygiene
gh-bootstrap.github/release.yml。--github指定時はマージ設定と空でないルールセットも確認gh-bootstrap
safe-settings.github/settings.yml（参考情報）safe-settings
config-review-bot.coderabbit.yamlconfig-review-bot
releasegit tag --listとCHANGELOG.mdrelease
justfilejustfilejustfile
ci-optimizeconcurrency:を含むワークフローの有無（参考情報）ci-optimize
build-optimizeスキップ — 実測の経過時間データが必要build-optimize
github-copilot-repo-instructions.github/copilot-instructions.mdまたは.github/instructions/*.instructions.mdgithub-copilot-repo-instructions
codeownersルート、docs/、または.github/内のCODEOWNERS。--github指定時はcodeowners/errorsエンドポイントも確認codeowners
actions-pinning40桁の16進数のコミットSHAに固定されていないuses:参照の数actions-pinning
pr-title-lintaction-semantic-pull-requestまたはcommitlintを含むワークフローpr-title-lint
labels-as-code.github/labels.ymlまたは.github/labeler.ymllabels-as-code
repo-attributes.gitattributes、.editorconfig、.gitignorerepo-attributes
branch-cleanup--github指定時のdelete_branch_on_mergebranch-cleanup
agents-mdAGENTS.mdが存在し、32 KiB未満で、およそ200行未満であることagents-md

各行のステータスはpass、warn、missing、skippedのいずれかです。skippedは、スクリプトが静的に取得できないデータが必要な場合（build-optimize）、または--githubが必要だが指定されていない場合（branch-cleanup）を意味し、リポジトリがチェックに失敗したという意味ではありません。

3. 表を読み、順序付きの計画を提案する

スクリプトが表を出力したら、missingとwarnの行を読み、各不足項目の担当となるカタログスキルを明記した順序付きの計画を提案します。依存関係がある場合は、それに従って不足項目を並べます（たとえば、gh-bootstrapでマージ関連の設定を固定してからoss-hygieneでコントリビューター向けファイルを追加します。また、ワークフローが存在する場合はactions-pinningの優先度が上がります）。自分で修正を適用してはいけません。不足項目ごとに、指定されたスキルへ引き継ぎます。

4. 書き込みや変更を伴う呼び出しは行わない

このスキルとそのスクリプトは、ファイルの作成、編集、削除を一切行わず、GitHub APIのPOST、PATCH、PUT、DELETEエンドポイントも呼び出しません。--githubで追加されるのはGET呼び出しのみです。ユーザーから監査で「そのまま修正して」と依頼された場合は断り、代わりに手順3の引き継ぎ計画を提示します。

参考資料

  • references/checks.md — チェックごとに1行で、検査対象のファイルまたはエンドポイントと、APIを使用する場合はdocs.github.comの引用元を記載します。

コメント

Markdown 対応