code-simplification について
最近変更されたコードを、動作やプロジェクト上の制約を保ちながら局所的に簡素化するスキルです。差分、不変条件、許可パス、成功済みチェックを含むコード変更ワークフローを対象とします。
主な機能
- 01入出力のバイト数制限
- 02具体的な局所簡素化の特定
- 03動作とプロジェクト規約の維持
- 04編集後の対象を絞ったチェック
- 05変更点と残る制約の報告
活用シーン
- 01最近の変更に含まれる重複の整理
- 02不要な間接化や分岐の削減
- 03必要な入力がバイト上限を超えた場合の停止
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ carlitose/ agent-skills --skill code-simplificationインストール後、Claude Code で/code-simplificationを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
コードの簡素化
担当範囲:最近変更されたコードを対象とする、焦点を絞った簡素化です。チケットの選定、スコープの拡大、受け入れ基準のレビュー、QA/監査成果物の作成、コミット、プッシュ、PR の作成、ワークフロー状態の確定は行いません。
入力
変更差分、許可されたパス、意味上の不変条件、プロジェクトの規約、現在パスしているチェックを必須とします。候補が GREEN でない場合は、編集せずに終了してください。
変動入力の上限
max_volatile_bytes:1 回の実行につき、正規化後の UTF-8 バイト数で103232。これは、観測された候補差分の最大値 96,393 バイトに、チケット本文の最大値 2,380 バイトと実装引き継ぎ情報の最大値 4,459 バイトを加えたものです。対象コーパスは、実行時の TK-01/TK-02/TK-05/TK-07/TK-08 の正規化されたgit diff --no-ext-diff --no-colorの出力、9 件のチケット本文、簡潔なリーフ結果です。max_single_output_bytes:32596。観測された TK-02 の実行可能コード候補差分です。
CRLF または単独の CR を LF に正規化した後の、すべての差分、ファイルの抜粋、貼り付けられた引き継ぎ情報、エビデンス本文、ツール結果をカウントしてください。まずマニフェストを読み、コマンド出力はコンテキストに入る前に切り詰め、大きな差分はファイルまたはハンク単位に分割してください。貼り付けた成果物より、パスと SHA-256 の参照を優先し、内容が必要な場合にのみ成果物をカウントしてください。次に必要な読み込みによっていずれかの上限を超える場合は、読み込みや編集を行う前に停止し、残りの参照を正確に示して budget-exhausted を返してください。後続の実行で作業を続けることができます。この上限を理由に、保持義務を省いたり、エビデンスなしに同等性を主張したりしてはなりません。
契約
以下を保持します。
- 外部から観測可能な動作と公開契約。
- エラー、検証順序、副作用、再試行、永続化の意味。
- セキュリティとデータ整合性の境界。
- チケットのスコープと、無関係なユーザー変更。
- テストとプロジェクトの規約。
プロセス
- 変更されたコードを文脈に沿って読み、具体的な重複、不要な間接化、分かりにくい名前、局所的に避けられる分岐を特定します。
- 意図が明確になる最小限の編集を優先します。推測に基づく抽象化、大規模なフォーマット変更、互換性のための回避策、アーキテクチャの書き換えは導入しません。
- 一貫性のある編集を行うたびに、関連する範囲で最も限定的なチェックを実行します。動作が同等であることを示せない場合は、簡素化を元に戻します。
- 変更したパス、行った簡素化、確認したチェック、残る制限を報告します。
観測したエビデンスなしに、同等性やチェックの合格を主張してはなりません。編集を行うと新しい CandidateRef が作成され、呼び出し元が管理する以前のレビュー/QA/監査エビデンスは無効になります。