agent-introspection-debugging SKILL.md skillA
agent-introspection-debugging from affaan-m/ecc is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add affaan-m/ecc/agent-introspection-debugging@git:20260517.ec9ace9Pins git:20260517.ec9ace9 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- affaan-m/ecc
- Path
docs/ja-JP/skills/agent-introspection-debugging/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260517.ec9ace9, committed May 17, 2026
- Size
- 7,598 bytes
- Repository stars
- 299,696
- License
- MIT
キャプチャ、診断、封じ込め回復、内省レポートを使用した AI エージェント障害のための構造化された自己デバッグワークフロー。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# エージェント内省デバッグ エージェント実行が繰り返し失敗している、進展なくトークンを消費している、同じツールをループしている、または意図したタスクから逸脱している場合にこのスキルを使用します。 これはワークフロースキルであり、隠れたランタイムではありません。エージェントが人間にエスカレーションする前に体系的に自己デバッグするよう教えます。 ## 起動タイミング - ツール呼び出しの最大数 / ループ制限の失敗 - 前進なしの繰り返しリトライ - 出力品質の低下を招くコンテキストの増大またはプロンプトのドリフト - 期待と現実の間でのファイルシステムや環境状態の不一致 - 診断とより小さな修正アクションで回復可能なツールの失敗 ## スコープ境界 このスキルを起動するのは以下の場合： - 盲目的にリトライする前に障害状態をキャプチャする - エージェント固有の一般的な障害パターンを診断する - 封じ込め回復アクションを適用する - 構造化された人間が読めるデバッグレポートを生成する このスキルを主なソースとして使用しない場合： - コード変更後の機能検証; `verification-loop` を使用 - より狭い ECC スキルが既に存在するフレームワーク固有のデバッグ - 現在のハーネスが自動的に強制できないランタイムの約束 ## 四フェーズループ ### フェーズ 1: 障害キャプチャ 回復を試みる前に、障害を正確に記録します。 キャプチャ内容： - エラーの種類、メッセージ、スタックトレース（利用可能な場合） - 最後の意味のあるツール呼び出しシーケンス - エージェントが何をしようとしていたか - 現在のコンテキスト圧力：繰り返されるプロンプト、過大なペーストされたログ、重複した計画、暴走するノート - 現在の環境の前提：cwd、ブランチ、関連するサービス状態、期待されるファイル 最小キャプチャテンプレート： ```markdown ## 障害キャプチャ - セッション / タスク: - 進行中の目標: - エラー: - 最後に成功したステップ: - 最後に失敗したツール / コマンド: - 観察された繰り返しパターン: - 検証すべき環境の前提: ``` ### フェーズ 2: 根本原因診断 何も変更する前に、障害を既知のパターンに照合します。 | パターン | 考えられる原因 | チェック | | --- | --- | --- | | ツール呼び出しの最大数 / 同じコマンドの繰り返し | ループまたは出口なしのオブザーバーパス | 最後の N 回のツール呼び出しを繰り返しについて検査する | …
Read the whole file at its exact version.
How to install
mdr add affaan-m/ecc/agent-introspection-debugging@sha256:357e86a40f02ad50The line at the top of this page pins the label git:20260517.ec9ace9, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_w2xmvr3dat5sttc7)
7 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on May 17, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (7598 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
affaan-m/ecc · 299,696 stars · license MIT · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_w2xmvr3dat5sttc7 GET https://markdownregistry.com/api/v1/resolve?ref=affaan-m/ecc/agent-introspection-debugging GET https://markdownregistry.com/api/v1/blob/357e86a40f02ad501144a451d08da917b35805080bfcb5c5af08bd81dfdacc20
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.