| name | agent-introspection-debugging |
| description | キャプチャ、診断、抑制されたリカバリ、内省レポートを用いた、AI エージェント障害向けの体系的なセルフデバッグワークフローです。 |
| origin | ECC |
Agent Introspection Debugging
このスキルは、エージェント実行が繰り返し失敗する、進捗なくトークンを消費する、同じツールでループする、または意図されたタスクからドリフトしている場合に使用します。
これはワークフロースキルであり、隠れたランタイムではありません。エージェントに対して、人間にエスカレートする前に体系的に自身をデバッグする方法を教えます。
発動タイミング
- ツール呼び出し上限・ループ制限による失敗
- 前進のないリトライの繰り返し
- 出力品質を劣化させ始めるコンテキスト肥大やプロンプトドリフト
- 期待と現実の間の file-system または環境状態の不一致
- 診断とより小さな是正アクションで回復可能な可能性が高いツール障害
スコープ境界
このスキルは以下の目的で発動します:
- 盲目的にリトライする前に障害状態をキャプチャする
- エージェント特有の一般的な障害パターンを診断する
- 抑制されたリカバリアクションを適用する
- 構造化された人間可読のデバッグレポートを生成する
以下の主目的には使用しないでください:
- コード変更後の機能検証。代わりに
verification-loop を使用
- より狭い範囲の ECC スキルが既に存在する、フレームワーク固有のデバッグ
- 現在の harness が自動強制できないランタイムの約束
4 フェーズループ
フェーズ 1: 障害キャプチャ
リカバリを試みる前に、障害を正確に記録します。
キャプチャすべき内容:
- エラータイプ、メッセージ、可能な場合はスタックトレース
- 最後の意味のあるツール呼び出しシーケンス
- エージェントが何をしようとしていたか
- 現在のコンテキスト圧: 繰り返されるプロンプト、過大なログの貼り付け、重複したプラン、または暴走するノート
- 現在の環境前提: cwd、ブランチ、関連するサービス状態、期待されるファイル
最小キャプチャテンプレート:
## Failure Capture
- Session / task:
- Goal in progress:
- Error:
- Last successful step:
Last failed tool / command:
Repeated pattern seen:
Environment assumptions to verify: