simplify-audit について
コードを評価し、レビュー用の変更セットを準備するチーム向けの簡素化監査スキルです。動作上の等価性とリスクを根拠に、合格・ステージ済み・未解決を報告し、実装はスキルの対象外とします。
主な機能
- 01簡素化ルーブリックに沿ったコード監査
- 02呼び出し箇所と関連契約の確認
- 03動作の等価性とリスクの評価
- 04合格・ステージ済み・未解決の報告
- 05低リスク変更の変更セット準備
活用シーン
- 01関数やモジュールの簡素化可能性を評価
- 02大規模リポジトリの監査範囲を分割
- 03検証可能な簡素化のレビュー資料を準備
- 04未解決の設計課題を意思決定へ引き継ぐ
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ venhdev/ skills --skill simplify-auditインストール後、Claude Code で/simplify-auditを入力して読み込まれたか確認します。
同梱ファイルreferences/simplify-rubric.md
詳細
simplify-audit — 簡素化の監査と変更セットのステージング
ドメインの評価基準
入力と境界
ファイル、関数、モジュール、サブシステム、またはリポジトリの範囲を受け取ります。対象、適用される契約、呼び出し元、関連するチェックを調査し、すべての作業を読み取り専用に保ちます。範囲の広さによって調査の深さは変わりますが、自動的に再設計へ進むことはありません。
候補を評価する前に、references/simplify-rubric.md を読みます。セマンティクス、エラー処理、所有権、公開契約を維持します。同等性の根拠がある変更のみを提案し、未解決のアーキテクチャ上の選択を、設計を暗黙に拡張することなく適切な経路へ回します。
入力範囲が広い場合は、まとまりのあるスライスを特定し、調査した内容と未調査の内容を報告します。十分に理解され、適切にリスクが低いスライスのみを、必要な連鎖的変更とともにステージングします。一部のサンプルだけでリポジトリ全体を網羅したと主張してはなりません。
状態
PASS:調査した範囲に、評価基準に反する価値ある簡素化はありません。簡潔に報告して終了します。STAGED:同等性の根拠、適用可能な参照情報、受け入れ基準によって裏付けられた、具体的で動作を維持する簡素化の変更セットがレビュー可能な状態です。UNRESOLVED:根拠、リスク、または設計上の判断により、信頼できるステージングができません。簡潔に所見と不足事項を報告します。
正式な出力仕様
# Simplification Audit: <Scope> · <PASS | STAGED | UNRESOLVED>
<Short-to-medium conclusion; rubric-based opportunities and inspected coverage.>
Basis: <Equivalence evidence, governing contracts, checks/references; omit for a clean report.>
Gap: <Uninspected scope or unresolved decision; omit if none.>
# Changeset: Simplify <Slice>
Acceptance: <Behavior and contracts that must remain unchanged.>
```text
|-- <subsystem>/
| `-- <file>
| `-- [UPDATE] <Rubric-based simplification and retained invariant>.
`-- <deep/path/to/caller>
`-- [UPDATE] <Necessary behavior-preserving cascade; omit if none>.
Summary: <N> files affected (<C> created, <U> updated, <M> moved, <D> deleted).
```
PASS または UNRESOLVED の場合、変更セット、受け入れ基準ブロック、ファイル概要はすべて省略します。これは条件付きでステージングする単一の監査成果物であり、必須の2種類のレポートではありません。
振り分け
- 埋め込みの変更セットが根拠に基づき、承認済みである場合は、同等性の根拠と受け入れ基準を含めて引き継ぎます → (/forge 経由)。
- 動作を維持するステージングに要件やトレードオフの解決が必要な場合 → (/clarify 経由)。
- 簡素化にアーキテクチャの方針決定が必要な場合 → (/architect-decision 経由)。
実行プロトコル
- 対象範囲を把握し、評価基準を適用します。局所的な作業は直接監査します。複数レイヤーにまたがる広範な対象では、まず調査の基点を絞り込み、境界、契約、ローカルの評価基準のパス、および所見・根拠・リスクをまとめるサブレポート仕様を示して、根拠のあるスライスを作業者に委任します。ディレクトリの一覧を作成するのではなく、所見を統合します。
- 問題がなければ
PASSを提示して終了します。信頼できるスライスがある場合は、その変更セットを埋め込んでSTAGEDを提示し、承認を待ちます。実装はこのスキルの対象外とします。変更ツリーの埋め込みに(via /changeset)は必要ありません。 - アーキテクチャ上の所有権、契約、またはトレードオフを変更する必要がある場合は、設計上の不足事項を示して
UNRESOLVEDを報告します。範囲が広いことだけでは、設計上の阻害要因になりません。 - レポート、ステージング、または設計担当への引き継ぎで終了します。リファクタリングの実装はこのスキルの対象外とします。
コメント
Markdown 対応