audit について
auditは、プロジェクトのルールとデザインスキル群に照らして指定範囲を確認し、根拠のある指摘を優先度付きレポートにまとめます。コードやUIのレビュー向けで、個別のUIルールではなく、範囲や手順、統合、判定を担います。
主な機能
- 01レビュー範囲の明示
- 02プロジェクト固有ルールの優先
- 03関連スキルの実行と記録
- 04根本原因ごとの指摘統合
- 05修正項目の順位付けとレポート作成
活用シーン
- 01未コミット差分やプルリクエストの確認
- 02セッションの依頼と変更内容の照合
- 03デザインスキルに基づくコードベースの評価
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/auditを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSEreport.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 | すべてのラベル、説明、ステータス文字列 |
prose | 文章作成が対象の場合、変更した投稿、ブレークダウン、デザインノート |
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 にしてはいけません。