Agent Introspection Debugging

# エージェント内省デバッグ

エージェント実行が繰り返し失敗している、進展なくトークンを消費している、同じツールをループしている、または意図したタスクから逸脱している場合にこのスキルを使用します。

これはワークフロースキルであり、隠れたランタイムではありません。エージェントが人間にエスカレーションする前に体系的に自己デバッグするよう教えます。

## 起動タイミング

- ツール呼び出しの最大数 / ループ制限の失敗
- 前進なしの繰り返しリトライ
- 出力品質の低下を招くコンテキストの増大またはプロンプトのドリフト
- 期待と現実の間でのファイルシステムや環境状態の不一致
- 診断とより小さな修正アクションで回復可能なツールの失敗

## スコープ境界

このスキルを起動するのは以下の場合：
- 盲目的にリトライする前に障害状態をキャプチャする
- エージェント固有の一般的な障害パターンを診断する
- 封じ込め回復アクションを適用する
- 構造化された人間が読めるデバッグレポートを生成する

このスキルを主なソースとして使用しない場合：
- コード変更後の機能検証; `verification-loop` を使用
- より狭い ECC スキルが既に存在するフレームワーク固有のデバッグ
- 現在のハーネスが自動的に強制できないランタイムの約束

## 四フェーズループ

### フェーズ 1: 障害キャプチャ

回復を試みる前に、障害を正確に記録します。

キャプチャ内容：
- エラーの種類、メッセージ、スタックトレース（利用可能な場合）
- 最後の意味のあるツール呼び出しシーケンス
- エージェントが何をしようとしていたか
- 現在のコンテキスト圧力：繰り返されるプロンプト、過大なペーストされたログ、重複した計画、暴走するノート
- 現在の環境の前提：cwd、ブランチ、関連するサービス状態、期待されるファイル

最小キャプチャテンプレート：

```markdown
## 障害キャプチャ
- セッション / タスク:
- 進行中の目標:
- エラー:
- 最後に成功したステップ:
- 最後に失敗したツール / コマンド:
- 観察された繰り返しパターン:
- 検証すべき環境の前提:
```

### フェーズ 2: 根本原因診断

何も変更する前に、障害を既知のパターンに照合します。

| パターン | 考えられる原因 | チェック |
| --- | --- | --- |
| ツール呼び出しの最大数 / 同じコマンドの繰り返し | ループまたは出口なしのオブザーバーパス | 最後の N 回のツール呼び出しを繰り返しについて検査する |
| コンテキストオーバーフロー / 推論の低下 | 無制限のノート、繰り返される計画、過大なログ | 最近のコンテキストを重複と低シグナルのバルクについて検査する |
| `ECONNREFUSED` / タイムアウト | サービスが利用不可または間違ったポート | サービスの健全性、URL、ポートの前提を確認する |
| `429` / クォータ枯渇 | リトライストームまたはバックオフなし | 繰り返し呼び出しを数え、リトライ間隔を検査する |
| 書き込み後にファイルが見つからない / 古い差分 | レース、間違った cwd、またはブランチドリフト | パス、cwd、git ステータス、実際のファイル存在を再確認する |