菜单
キャプチャ、診断、抑制されたリカバリ、内省レポートを用いた、AI エージェント障害向けの体系的なセルフデバッグワークフローです。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | agent-introspection-debugging |
| description | キャプチャ、診断、抑制されたリカバリ、内省レポートを用いた、AI エージェント障害向けの体系的なセルフデバッグワークフローです。 |
| origin | ECC |
このスキルは、エージェント実行が繰り返し失敗する、進捗なくトークンを消費する、同じツールでループする、または意図されたタスクからドリフトしている場合に使用します。
これはワークフロースキルであり、隠れたランタイムではありません。エージェントに対して、人間にエスカレートする前に体系的に自身をデバッグする方法を教えます。
このスキルは以下の目的で発動します:
以下の主目的には使用しないでください:
verification-loop を使用リカバリを試みる前に、障害を正確に記録します。
キャプチャすべき内容:
最小キャプチャテンプレート:
## Failure Capture
- Session / task:
- Goal in progress:
- Error:
- Last successful step:
- Last failed tool / command:
- Repeated pattern seen:
- Environment assumptions to verify:
何かを変更する前に、障害を既知のパターンと一致させます。
| パターン | 想定原因 | 確認方法 |
|---|---|---|
| ツール呼び出し上限 / 同一コマンドの繰り返し | ループまたは終了なしの observer パス | 直近 N 件のツール呼び出しを調べて繰り返しを確認 |
| コンテキストオーバーフロー / 推論の劣化 | 上限のないノート、プラン重複、過大なログ | 最近のコンテキストで重複と低シグナルの塊を確認 |
ECONNREFUSED / タイムアウト | サービス停止中または誤ったポート | サービスヘルス、URL、ポート前提を検証 |
429 / クォータ枯渇 | リトライストームまたはバックオフ欠如 | 繰り返し呼び出しを数え、リトライ間隔を調査 |
| 書き込み後のファイル欠如 / 古い diff | レース、誤った cwd、またはブランチドリフト | パス、cwd、git status、実際のファイル存在を再確認 |
| 「修正」後もテスト失敗 | 誤った仮説 | 正確な失敗テストを分離し、バグを再導出 |
診断質問:
診断面を変える最小のアクションでリカバリします。
安全なリカバリアクション:
実際に現在の環境で本物のツールを通じて行っているのでない限り、「エージェント状態をリセット」や「harness 設定を更新」といった、サポートされていない自動修復アクションを主張しないでください。
抑制されたリカバリチェックリスト:
## Recovery Action
- Diagnosis chosen:
- Smallest action taken:
- Why this is safe:
- What evidence would prove the fix worked:
次のエージェントまたは人間にリカバリが理解できるようレポートで締めくくります。
## Agent Self-Debug Report
- Session / task:
- Failure:
- Root cause:
- Recovery action:
- Result: success | partial | blocked
- Token / time burn risk:
- Follow-up needed:
- Preventive change to encode later:
以下の介入を順に優先します:
悪いパターン:
良いパターン:
verification-loop を使用してリカバリします。continuous-learning-v2 を使用します。council を使用します。workspace-surface-audit を使用します。このスキルが有効な場合、「修正しました」だけで終えないでください。
常に以下を提供します:
リポジトリ認識の並列レビューパスを使用してスキル、コマンド、ルール、フック、その他を DAILY と LIBRARY のバケットに分類することで、特定のリポジトリ向けにエビデンスに基づく ECC インストールプランを構築します。フルバンドルをロードするのではなく、プロジェクトが実際に必要とするものに ECC をトリミングすべき場合に使用します。
対象リポジトリの既存の統合パターンに正確に合わせて新しい API コネクタやプロバイダを構築します。第二のアーキテクチャを発明することなく、もう一つの統合を追加する場合に使用します。
Write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use when the user wants polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter.
ECC 向けのエビデンスファーストな自動化インベントリと重複監査のワークフローです。何かを修正する前に、どのジョブ、フック、コネクタ、MCP サーバー、またはラッパーがライブ、壊れている、冗長、または欠落しているかをユーザーが知りたい場合に使用します。
CodeTour の `.tour` ファイルを作成します。実際のファイルと行のアンカーを持つペルソナ対象のステップバイステップウォークスルーです。オンボーディングツアー、アーキテクチャウォークスルー、PR ツアー、RCA ツアー、および構造化された「これがどのように動作するか説明して」というリクエストに使用します。
命名、可読性、不変性、コード品質レビューのための、プロジェクト横断で共通のベースラインとなるコーディング規約です。フレームワーク固有のパターンには、詳細なフロントエンド／バックエンド向けスキルを使用してください。