ユーザーはレトロスペクティブを求めています。コーディングエージェントの環境を改善し、将来の実行をより良いものにするための提案を行ってください。
手順
-
ライティングスタイルガイドとして
writing-for-agentsスキルツールを呼び出します。 -
ユーザーが指定したセッションの一次情報源を読み込みます。これは、このマシン上のセッションログを検索することを意味する場合があります。ユーザーがセッションを指定しない場合は、現在のセッションをデフォルトとします。
-
以下のカテゴリで改善の候補を探します。
- ナビゲーション: エージェントが正しいファイルを見つけるのはどれほど簡単でしたか？ファイル間に隠れた依存関係はありますか？ナビゲーションポインターがあると簡単になりますか？使用タイミング: セッションで情報を見つけるのに長時間かかった場合。
- 自動チェック: エージェントのエラーをキャッチできる自動チェックはありますか？リンティング、型チェック、テスト、ファイルシステムリンターなど。まずリポジトリ自身のチェックコマンド（
package.json/ビルドツールのlint/checkスクリプト、CIワークフロー）を読み、既に存在するが配線されていない、または静かに壊れているチェックを発見することに重点を置き、再発明は避けてください。ガードレール（pre-commitフックもCIジョブもlint/typecheck/testコマンドを実行していない）がないリポジトリ自体が発見事項です：リントされていないリポジトリは、放置された機会損失であり、中立的なデフォルトではありません。使用タイミング: エージェントが自動チェックで防げたはずのミスを犯した場合、またはリポジトリにガードレールがまったくない場合。 - コーディング標準: レビューエージェントに新しいルールを強制させるべきですか？既存のルールを削除または明確化すべきですか？まず違反を分類します：機械的な違反（固定された構文パターン、禁止されたAPI、インポート形状、ファイル配置ルール）は決定論的なチェック対象であり、それで終わりです：リポジトリの言語と既存のガードレールに基づいて最も安価な方法（リポジトリのリンターのカスタムルール、新しいpre-commitフック、新しいCIジョブ）を選びます。ルールを書くよりもチェックを構築することをデフォルトにします。
CODING_STANDARDS.mdは真の判断を要する事項（ファイル間の一貫性、「周囲のスタイルに合っているか」、ガードレールでは決して代替できないもの）のために予約してください。使用タイミング: レビューエージェントがミスを見逃した場合。 - グローバルAGENTS.md: コーディング標準（または自動チェック）に移行すべき指示はありませんか？使用タイミング: AGENTS.mdファイルが特に大きい場合（リポジトリ内またはユーザーのグローバルスコープの両方）。
- ツール経済性: エージェントが非効率なツール呼び出しを行いましたか？特にトークン効率の悪いカスタムツール（CLI、MCP）はありませんか？使用タイミング: エージェントが高コストなツール呼び出しを行った場合。
- ノーオペレーション: ステアリングファイル内に、エージェントの動作を変更しない指示がないか探します。使用タイミング: ステアリングファイルが大きく扱いにくい場合。
- 情報アクセス: エージェントの情報アクセスを増やす機会を探します。開発サーバーのログのティー出力、サードパーティサービスへの読み取り専用アクセスなど。使用タイミング: 重要な情報がエージェントに利用できなかった場合。
- これらの候補を重大度順にユーザーに提示します。
参考
実装とレビュー
すべての作業は実装とレビューの2段階を経ることを忘れないでください。実装エージェントは最もコンテキスト圧力が高くなります。彼らは探索、コード作成、デバッグを担当します。
レビューエージェントはコンテキスト圧力が最も低くなります。差分を受け取るため探索は不要で、コードを書いたりデバッグしたりする必要もほとんどありません。
これは、コーディング標準を課す責任はレビューエージェントにあり、実装エージェントではないことを意味します。
ファイル
リポジトリ内では以下のファイルにアクセスできます：
CLAUDE.md/AGENTS.md: これらのファイルはこのリポジトリで作業する任意のエージェントのコンテキストウィンドウにプッシュされます。非常に控えめに使用し、通常は他のファイルへのナビゲーションポインターにのみ使用します。CODING_STANDARDS.md: このファイルはレビュー中に読み込まれ、実装中には読み込まれません。標準ファイルが1,000行を超える場合は、ドキュメントフォルダへのナビゲーションポインターを追加します。- ドキュメント: ドキュメントは他のファイルから参照される参照ファイルとして使用します。新しいドキュメントを作成する前に既存のドキュメントを探します。
- スキル: スキルはドキュメント（説明がエージェントのコンテキストウィンドウに入るため）や、ユーザーが呼び出すコマンドに使用します。
writing-for-agentsスキルのアドバイスに従ってください。