audit について
複数のルールに沿って作業を監査するスキルです。対象範囲を定め、関連するレビュー用スキルを実行して指摘を統合・順位付けし、番号付きレポートを作成します。修正はユーザーが選んだ項目に限ります。
主な機能
- 01監査対象の範囲を明示
- 02プロジェクト固有ルールを確認
- 03複数のレビュー用スキルを実行
- 04根本原因ごとに指摘を統合
- 05修正項目を順位付けして番号化
活用シーン
- 01未コミットの変更の監査
- 02複数のルール検査結果の統合
- 03対応すべき問題の優先順位付け
- 04ユーザーが選んだ指摘の修正
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/auditを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
report.htmlreport.mdagents/openai.yaml詳細
監査
このスキルは、このコレクション内のすべてのルールに照らして作業を一度に確認します。それぞれの懸念事項を担当するスキルに送り、結果を統合して、優先順位を付けたレポートにまとめます。
ルールではなく、レポート
このスキルはインターフェースのルールを担当しません。担当するのは、確認範囲、確認の順序、結果の統合、判定です。各指摘には、その指摘を担当するスキルのルール ID を記載します。指摘には、コード、実行中のアプリ、またはスレッドからの根拠が必要です。単なる好みは根拠になりません。
レポートの形式は report.md にあります。
1. 確認範囲を明示する
確認対象を明記します。未コミットの差分、ブランチ、プルリクエスト、このセッションのリクエスト、またはコードベース全体のいずれかです。確認範囲が明記されていない監査は audit-state-the-scope です。
2. プロジェクトのルールを読む
AGENTS.md、CLAUDE.md、エディタールールのフォルダーを読みます。プロジェクトに明記されたルールは、ここにあるデフォルトより優先されます。明記されたルールに従っているコードへの指摘は audit-project-rules-first です。
3. すべてのスキルを実行する
確認範囲を各スキルに照らして確認し、調査した内容を記録します。
| スキル | 確認内容 |
|---|---|
verify | 変更された各箇所を実行中のアプリで開く |
scope | スレッド内の各リクエストを差分と照合する |
reuse | 新しいコンポーネント、スタイル、アイコンを共有パッケージと照合する |
restraint | 要求されていない UI、設定、フォールバック、デッドコード、説明的なコメント |
copy | すべてのラベル、説明、ステータス文字列 |
defaults | 対象箇所、種類、音、フォーカス、名前、フォーム、読み込み、ホットキー、ダイアログ |
motion | すべての遷移、アニメーション、ジェスチャー、終了処理 |
color | 各テーマでのテキストとフィールドのコントラスト、コンポーネント内のトークン、アクセントカラー |
gather | 各リファレンスボード：プラットフォーム、リンク、取り入れる箇所 |
match | 名前が挙げられた各リファレンス（作業でそれを模倣する場合） |
rule | 文書化されたルールがない繰り返しの修正、およびルールに違反する編集 |
viewports | レイアウトが確認範囲に含まれる場合、変更された各レイアウトをすべての幅で確認する |
ship | Git が確認範囲に含まれる場合、余分なファイル、シークレット、コミット、チェック |
理由を説明せずにスキルを省略すると audit-run-every-skill です。
4. 根本原因ごとにまとめる
1つの原因が2つのスキルのルールに違反する場合、両方の ID を付けた1つの指摘にします。同じ局所的な修正で対処できる5つの呼び出し箇所は、5つの箇所を記載した1つの指摘にします。症状をそれぞれ別の行に並べると audit-one-row-per-cause です。
5. 修正に番号を振り、レポートを開く
指摘を重大度、次に影響範囲の広さで順位付けします。ユーザーが「1、2、5を修正」と回答できるよう、番号を付けます。
report.html を、無視対象のフォルダーでありソースツリーではない .audit/<scope>/index.html にコピーします。ヘッダーコメントに示された形式で、隣に report.js を作成し、レポートを開きます。
レポートの外観はスキルに含まれているため、データだけを書き込みます。独自のマークアップやスタイルを使ったページは audit-shipped-report です。
ユーザーは Pick で指摘を選び、Copy Picks で選択内容を貼り付けます。選択を待ってから、選ばれた番号だけを修正します。ユーザーが選ぶ前にすべて修正すると audit-fix-what-was-picked です。
対比
すべての確認は対比で示します。問題のある行の隣に、置き換える行を記載します。
| ルール | 問題のある例 | 置き換え例 |
|---|---|---|
audit-state-the-scope | 「アプリを監査した」 | 「未コミットの差分を監査した：14ファイル」 |
audit-project-rules-first | ルールで必須とされている境界線をリポジトリ内で指摘する | プロジェクトのルールを引用し、指摘しない |
audit-run-every-skill | copy を黙って省略する | 「copy：文字列の変更なし」 |
audit-one-row-per-cause | プリミティブの修正漏れ1件に対して5行作成する | 5つの箇所を記載した1行 |
audit-shipped-report | レポートページを一から作成する | report.html をコピーし、report.js だけを作成する |
audit-fix-what-was-picked | 問われていないのに18件すべてを修正する | ユーザーが選んだ番号だけを修正する |
レポート
report.md の重大度の基準と形式を使用します。HIGH が1件でも残っている場合は Block、それ以外は Approve とします。開いたり読んだりしていない作業を Approve にしてはいけません。