用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt;运行前请先检查来源。
npx skills add https://github.com/lza6/Claude-code-cli-config --skill agent-introspection-debugging命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地?可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | agent-introspection-debugging |
| description | 针对 AI 代理 (Agent) 失败的结构化自调试工作流,包括捕捉、诊断、受控恢复和内省报告。 |
| origin | ECC |
当代理运行反复失败、在没有进展的情况下消耗令牌 (Tokens)、循环调用相同的工具,或者偏离预期任务时,请使用此技能。
这是一个工作流技能,而不是隐藏的运行时。它教导代理在升级到人工处理之前系统地调试自身。
在以下情况下激活此技能:
不要将此技能作为以下情况的主要来源:
verification-loop在尝试恢复之前,精确记录失败情况。
捕捉内容:
最低限度的捕捉模板:
## 失败捕捉
- 会话 / 任务:
- 进行中的目标:
- 错误:
- 最后一个成功的步骤:
- 最后一个失败的工具 / 命令:
- 观察到的重复模式:
- 待验证的环境假设:
在更改任何内容之前,将失败与已知模式匹配。
| 模式 | 可能的原因 | 检查项 |
|---|---|---|
| 达到最大工具调用次数 / 反复执行同一命令 | 循环或无退出的观察者路径 | 检查最后 N 次工具调用是否存在重复 |
| 上下文溢出 / 推理能力下降 | 无限制的笔记、重复的计划、过大的日志 | 检查最近的上下文是否存在重复和低信号的冗余信息 |
ECONNREFUSED / 超时 | 服务不可用或端口错误 | 验证服务健康状况、URL 和端口假设 |
429 / 配额耗尽 | 重试风暴或缺少退避机制 | 统计重复调用次数并检查重试间隔 |
| 写入后文件丢失 / 差异过时 | 竞态、错误的 cwd 或分支漂移 | 重新检查路径、cwd、git 状态以及文件的实际存在情况 |
| “修复”后测试仍然失败 | 假设错误 | 隔离确切的失败测试并重新推导错误原因 |
诊断问题:
使用能改变诊断表面的最小操作进行恢复。
安全的恢复操作:
除非您确实在当前环境中使用真实工具执行这些操作,否则不要声称不支持的自动修复操作,如“重置代理状态”或“更新框架配置”。
受控恢复检查清单:
## 恢复操作
- 选择的诊断:
- 采取的最小操作:
- 为什么这是安全的:
- 证明修复有效的证据:
最后提交一份报告,使恢复过程对下一个代理或人类清晰可见。
## 代理自调试报告
- 会话 / 任务:
- 失败情况:
- 根本原因:
- 恢复操作:
- 结果: 成功 | 部分成功 | 被阻塞
- 令牌 / 时间损耗风险:
- 之后需要的跟进:
- 稍后需要编码的预防性变更:
按以下顺序优先选择干预措施:
错误模式:
正确模式:
verification-loop。continuous-learning-v2。council。workspace-surface-audit。当此技能激活时,不要仅以“我修复了它”结尾。
始终提供: