simplify について
変更コードをレビューし、動作を保つと確認できた改善を適用するスキルです。再利用、簡素化、効率、抽象化の境界を検討し、対象を変更しない報告専用モードも備えています。
主な機能
- 01変更全体と関連文脈のレビュー
- 02再利用・簡素化・効率・境界の確認
- 03意図した動作に照らした指摘の検証
- 04最小限の整理とチェックの実施
- 05対象を変更しない報告専用モード
活用シーン
- 01変更で追加されたコードの簡素化
- 02差分を変更せずにレビュー
- 03関連テストで整理内容を検証
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ wkentaro/ agent-skills --skill simplifyインストール後、Claude Code で/simplifyを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlevals/evals.json
詳細
Simplify
正しさのバグを探すことなく、変更したコードの品質を向上させます:
/simplify [target]
指定された対象がある場合は、それを使用します。ない場合は、現在の作業ツリーとブランチの差分をベースとの差分と照らして確認します。既存のリポジトリヘルパーに置き換えるほうが簡潔な場合を除き、作業範囲は変更されたコードの範囲内にとどめます。
通常モードでは、検証済みのクリーンアップを適用します。親ワークフローまたは呼び出し元が報告のみの境界を設定している場合は、報告のみモードを使用し、対象を変更しません。
変更を確認する
差分全体、その呼び出し元、関連するリポジトリの指示、意図された動作を明らかにするテストやドキュメントを読みます。次に、各観点に対して新しい報告のみの Reviewer を 1 人ずつ割り当てます。可能な限り並行して実行し、必要な場合にのみ直列化します。処理能力を理由に、観点を省略してはいけません。
| 観点 | 確認基準 |
|---|---|
| 再利用 | 動作を維持でき、より明確になる場合は、新たな重複を既存のヘルパー、ユーティリティ、型、またはインストール済みの依存関係に置き換えます。 |
| 簡素化 | 変更によって生じた、または明らかになった冗長な状態や導出可能な状態、不要な分岐やネスト、コピペによる差異、間接化、未使用コードを取り除きます。 |
| 効率性 | 実証された反復処理、不要な I/O や割り当て、過度に広範な処理を取り除きます。推測に基づくマイクロ最適化は避けます。 |
| 抽象度 | ポリシー、オーケストレーション、低レベルの処理を既存の適切な境界に保ちます。新しいレイヤーを追加するのではなく、漏れのある抽象化や単なる受け渡しの抽象化を取り除きます。 |
各 Reviewer は、場所、1 行の指摘、具体的なコスト、根拠、動作を維持する最小限の修正案を含む指摘のみを返すか、No findings. を返します。Reviewer は編集、コミット、公開、委任を行いません。
統合する
同じ仕組みを指摘する内容は重複を除き、それぞれをソースと意図された動作に照らして検証します。コストが具体的で、修正案が作業範囲内に収まり、意図された動作が変わらない場合に限り、指摘を残します。誤検知、スタイルだけの変更、推測に基づく柔軟性、周辺の広範なリファクタリングが必要な修正案は却下します。
正しさに関するバグの疑いは、このスキルの対象外として扱い、code-review を推奨します。クリーンアップとして扱ってはいけません。
報告のみモード
検証済みの指摘と、却下した主張およびその理由を返します。問題がなければ No findings. を返します。対象を変更していないことを明記します。このモードは Composite Review Skill です。出所には、最上位の Simplify Reviewer と 4 人全員の観点別 Reviewer が含まれます。
適用モード
検証済みのクリーンアップをすべて、まとまりのある最小限の編集として適用します。関連する範囲に絞ったテスト、リンター、型チェックに加え、変更した出力面を直接確認します。チェックに合格し、意図された動作が変わっていないことを引き続き実証できる場合に限り、編集を残します。
最後に、修正内容、理由を添えて見送った指摘、実施したチェックを簡潔に列挙するか、コードがすでにクリーンだったことを確認します。履歴と公開は呼び出し元に任せます。コミット、リベース、コメント、プッシュは行いません。