Agent卡死怎么办？这个Skill教AI给自己看病——Structured Self-Debugging实战

Claude Code 跑着跑着突然开始鬼打墙——同一个工具调用三次、上下文疯涨、输出质量肉眼可见地下降，然后它就卡死了，你只能从头再来。

有没有想过：其实 AI Agent 也需要一个”自我诊断”的流程？

今天挖到一个很硬核的 Skill——Agent Introspection Debugging，来自 26.9 万星的 affaan-m/ECC 仓库。它不是帮你修 bug，而是一套教 AI Agent 怎么给自己看病的Structured Workflow。

核心理念：先记录，再动手

大多数 Agent 出问题时的本能反应是”retry”——重试一次说不定就成了。但这个 Skill 教 Agent 在重试之前，先做四件事：

• Failure Capture——把错误状态完整记录下来：错误信息、堆栈、最后一步在干什么、当前环境假设是什么
• Root-Cause Diagnosis——用一套诊断表对号入座，判断是”循环陷阱”还是”上下文溢出”还是”服务挂了”
• Contained Recovery——用最小改动来验证诊断结果，而不是大面积推倒重来
• Introspection Report——输出一个结构化报告，让下一个接手的 Agent 或人类能看懂发生了什么

什么时候用它？

• 工具调用次数撞到上限但 Agent 还在重复尝试
• 上下文 Token 爆炸，输出质量开始下降
• Agent 在同一个文件上循环修改但测试仍然失败
• 服务连接报 ECONNREFUSED 或触发 429 限流

简单说：当你发现 Agent 进入”无效努力”状态时，激活这个 Skill。

为什么值得装？

它把 Agent 的调试过程从”凭感觉 retry”变成了一套可复盘的诊断流程。输出标准化意味着：即使这次没修好，下次其他 Agent 接手时也能快速定位问题，而不是从头再踩一遍坑。

对于天天和 Claude Code / Codex 打交道的人来说，这个 Skill 相当于给 Agent 装了一个内置的”黑匣子记录仪”——出了问题有据可查，而不是一团乱麻的 token 消耗。

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