エージェント実行が繰り返し失敗している、進展なくトークンを消費している、同じツールをループしている、または意図したタスクから逸脱している場合にこのスキルを使用します。
これはワークフロースキルであり、隠れたランタイムではありません。エージェントが人間にエスカレーションする前に体系的に自己デバッグするよう教えます。
このスキルを起動するのは以下の場合：
このスキルを主なソースとして使用しない場合：
verification-loop を使用回復を試みる前に、障害を正確に記録します。
キャプチャ内容：
最小キャプチャテンプレート：
## 障害キャプチャ
- セッション / タスク:
- 進行中の目標:
- エラー:
- 最後に成功したステップ:
- 最後に失敗したツール / コマンド:
- 観察された繰り返しパターン:
- 検証すべき環境の前提:
何も変更する前に、障害を既知のパターンに照合します。
| パターン | 考えられる原因 | チェック |
|---|---|---|
| ツール呼び出しの最大数 / 同じコマンドの繰り返し | ループまたは出口なしのオブザーバーパス | 最後の N 回のツール呼び出しを繰り返しについて検査する |
| コンテキストオーバーフロー / 推論の低下 | 無制限のノート、繰り返される計画、過大なログ | 最近のコンテキストを重複と低シグナルのバルクについて検査する |
ECONNREFUSED / タイムアウト |
サービスが利用不可または間違ったポート | サービスの健全性、URL、ポートの前提を確認する |
429 / クォータ枯渇 |
リトライストームまたはバックオフなし | 繰り返し呼び出しを数え、リトライ間隔を検査する |
| 書き込み後にファイルが見つからない / 古い差分 | レース、間違った cwd、またはブランチドリフト | パス、cwd、git ステータス、実際のファイル存在を再確認する |
| 「修正」後もテストが失敗し続ける | 間違った仮説 | 失敗している正確なテストを分離し、バグを再導出する |
診断の質問：
診断の表面を変える最小のアクションで回復します。
安全な回復アクション：
現在の環境の実際のツールを通じて実際にそれらを行っていない限り、「エージェント状態をリセット」または「ハーネス設定を更新」のような自動回復アクションを主張しないこと。
封じ込め回復チェックリスト：
## 回復アクション
- 選択した診断:
- 取った最小アクション:
- なぜこれが安全か:
- 修正が機能したことを証明するエビデンスは何か:
次のエージェントや人間が回復を理解できるレポートで終了します。
## エージェント自己デバッグレポート
- セッション / タスク:
- 障害:
- 根本原因:
- 回復アクション:
- 結果: 成功 | 部分的 | ブロック中
- トークン / 時間の消費リスク:
- 必要なフォローアップ:
- 後でエンコードすべき予防的変更:
この順序で介入を優先する：
悪いパターン：
良いパターン：
verification-loop を使用する。continuous-learning-v2 を使用する。council を使用する。workspace-surface-audit を使用する。このスキルがアクティブな場合、「修正しました」だけで終わらないこと。
常に提供する：