针对 AI 代理 (Agent) 失败的结构化自调试工作流，包括捕捉、诊断、受控恢复和内省报告。
npx skills add https://github.com/lza6/Claude-code-cli-config --skill agent-introspection-debuggingCopiez et collez cette commande dans Claude Code pour installer le skill
| 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。当此技能激活时，不要仅以“我修复了它”结尾。
始终提供：
设置并使用 1Password CLI (op)。在安装 CLI、启用桌面应用集成、登录（单个或多个帐户）或通过 op 读取/注入/运行密钥时使用。
停止等待提示词，让工作继续进行。
Agent 体验守护系统。解决AI助手常见体验问题 ：长时间无响应、任务卡死、中英文混用、状态不透明。包含看门狗监控、智能状态汇报、即时状态查询、语言一致性过滤、消息队列追踪。适用于所有渠道 （ QQ微信//Telegram飞书//Discord等 ）。当用户抱怨等太久没回复、 “回复中英文混着”、 “不知道在干什么”时使用此技能。
AI 代理的记忆管理工具 - 列表显示、搜索查找、摘要生成及记忆文件维护。包含 AI 驱动的摘要功能。
通过自主子代理编排复杂任务。将宏观任务分解为子任务，生成带有动态 SKILL.md 文件的专用子代理，协调基于文件的通信，整合结果，并在完成后解散代理。强制触发词：orchestrate (编排), multi-agent (多代理), decompose task (分解任务), spawn agents (孵化代理), sub-agents (子代理), parallel agents (并行代理), agent coordination (代理协调), task breakdown (任务拆解), meta-agent (元代理), agent factory (代理工厂), delegate tasks (委派任务)
通过并行且具备仓库感知的审查过程，将技能、命令、规则、钩子和附加项分类到 DAILY (日常) 与 LIBRARY (库) 桶中，为特定仓库构建有证据支持的 ECC 安装计划。当需要将 ECC 裁剪到项目实际需要的内容，而非加载完整包时使用。