polishing

仕上げ

PR を作成する前にコード変更を最終調整するための包括的なワークフローです。このスキルにより、コード品質とコードベースのパターンとの一貫性を確保し、よくある AI 生成の不要なコードを取り除きます。

ワークフロー

ステップ 1：ブランチのコンテキストを把握する

Skill ツールを使って recover-branch-context を呼び出し、ブランチの目的を把握します。

これにより、次の重要な情報を得られます。

• 現在のブランチの目的と目標
• 加えられた変更
• 実装しようとしている機能

ステップ 2：適用されるガイドラインとの照合

.agents/skills/ ディレクトリを調べ、変更したファイルに関係するガイドラインがあるスキルを探します。

変更したファイルで使われているテクノロジーに基づいてスキルを特定します。たとえば、React コンポーネントを変更した場合は React パターンのスキルを探し、ORM を使用した場合は関連する ORM のスキルを探します。

適用される各スキルについて、次の手順を行います。

1. サブエージェントを起動し、そのスキルのガイドラインに照らして変更したファイルをレビューします
2. 確立されたパターンからの逸脱があれば報告します
3. 適切であれば逸脱を修正し、そうでなければ議論のために記録します

ステップ 3：AI 生成の不要なコードを取り除く

デフォルトブランチとの差分を確認し、このブランチで追加された AI 生成の不要なコードをすべて取り除きます。

次のようなものが含まれます。

• 人間なら追加しない、またはファイルの他の部分と一貫しない余分なコメント
• コードベースのその領域では不自然な余分の防御的チェックや try/catch ブロック（特に、信頼済み／検証済みのコードパスから呼び出される場合）
• 型の問題を回避するための any へのキャスト
• ファイル内の他の部分と一貫しない、その他のスタイル

ステップ 4：最終レビュー

変更を最終レビューし、差分を確認して、問題がありそうな点を指摘します。

ステップ 5：報告

次の内容を要約します。

• ブランチのコンテキストを把握：ブランチの目的
• 確認したガイドラインと見つかった逸脱：適用されたスキル、および検証または修正したパターン
• 取り除いた不要なコード：整理した AI 生成の成果物
• レビュー結果：最終レビューで見つかった問題