← 一覧へ
✅ テスト・チェックCC / Codex 両対応難易度: 中級

エージェント内省デバッグ agent-introspection-debugging

AIエージェントの失敗をしっかり診断!

出典リポの★
248,548
最終更新
28日前
作者
affaan-m

これは何?

これは、AIエージェントが繰り返し失敗した時に、自己デバッグを行うためのスキルです。失敗の状態を正確に記録し、原因を特定し、小さな修正アクションを取ることで、問題を解決します。再現可能な診断と回復を実現するため、無駄なリトライを減らし、効率的な問題解決をサポートします。

エージェント内省デバッグの紹介マンガ

これでできること

  • 失敗の状態を正確に記録できる
  • 失敗の根本原因を特定できる
  • 小さな修正アクションを取れる
  • 構造化されたデバッグレポートを作成できる

こんな時に便利

エージェントが同じツールを繰り返し呼び出す時
コンテキストが大きくなり、出力品質が低下した時
ファイルや環境の状態が期待通りでない時
ツールが失敗し、診断と小さな修正アクションが必要な時

使い方

このスキルは、エージェントが繰り返し失敗した時にアクティブにします。まず失敗の状態を記録し、次に根本原因を特定し、小さな修正アクションを取ります。最後に、構造化されたデバッグレポートを作成し、状況を明確にします。これを繰り返すことで、無駄なリトライを減らし、効率的に問題を解決します。

使用例(こう頼んでみよう)

エージェントが同じツールを繰り返し呼び出しているので、診断してください。このタスクが失敗しました。根本原因を特定し、修正アクションを提案してください。コンテキストが大きくなり、出力品質が低下しています。デバッグレポートを作成してください。

必要なもの

  • 特になし

導入方法

いちばん簡単(AIに頼む)
次のスキルを入れて: https://github.com/affaan-m/ECC/tree/main/.agents/skills/agent-introspection-debugging
手動で置く
Claude Code → ~/.claude/skills/agent-introspection-debugging/
Codex → ~/.agents/skills/agent-introspection-debugging/

使いこなしのコツ

  • 失敗した状態を正確に記録することが重要です。
  • 小さな修正アクションを取ることで、リスクを最小限に抑えましょう。
  • 構造化されたデバッグレポートを作成し、次のアクションを明確にしましょう。