AI agent 翻车现场有救了，23万⭐仓库这套自检流程值得每个开发者装上

你有没有盯着 Claude Code 看它重复敲同一条命令、改同一个文件、token 狂飙到熔断？那种「明明已经翻车，但还在努力翻车」的画面，最近在 23 万 ⭐ 的明星仓库 affaan-m/ECC 里，被 agent-introspection-debugging 直接治住了。

核心思路一句话：AI agent 反复失败时不该继续重试，应该先停下来做四阶段自检——Capture（写失败现场）→ Diagnosis（对照 6 种常见故障模式）→ Recovery（最小可逆动作）→ Report（出诊断报告）。

它把 6 种翻车模式写进 Skill

• 最大循环——没退出条件，看最近 N 次工具调用是否雷同。
• 上下文溢出——无界粘贴日志、重复方案，搜最近 context 找低信号堆料。
• ECONNREFUSED / timeout——服务挂了或端口不对，先验健康。
• 429 / 配额爆——重试风暴没退避，数调用间隔。
• 文件刚写就没了——race、cwd 漂移、git 分支错位，重新对路径。
• 修完测试还红——诊断假设错了，先隔离单条失败测试再反推。

跟 LangSmith Fetch 是两条路线

之前推荐过的 LangSmith Fetch 是「把外部 trace 拉回来」——观测在外；这个 Skill 把诊断逻辑写进 agent 行为本身——自省在内。两者搭配更稳：LangSmith 给你看完整调用链，agent-introspection-debugging 让 agent 在断点处停一停、问自己「我到底卡在哪」。

装上即跑——一个 SKILL.md，Claude Code / Codex / Cursor / Opencode 自动加载，不起服务、不改 prompt。触发时机写得很死，没翻车它不会乱介入。

👉 GitHub：https://github.com/affaan-m/ECC/tree/main/skills/agent-introspection-debugging

GitHub: https://github.com/affaan-m/ECC/tree/main/skills/agent-introspection-debugging