$ loading_
帮助排查AI代理故障，执行结构化诊断、受限恢复并生成内省报告。
复制安装指令，让 AI 自动完成配置 · 推荐新手
请帮我安装 askskill 上的 "agent-introspection-debugging" 技能： 1. 下载 https://raw.githubusercontent.com/affaan-m/ECC/main/docs/zh-CN/skills/agent-introspection-debugging/SKILL.md 2. 保存为 ~/.claude/skills/agent-introspection-debugging/SKILL.md 3. 装好后重载技能，告诉我可以用了
请对这个AI代理故障执行结构化自调试：代理在调用工具后不断重复同一步骤并最终超时。请按“故障捕获、可能根因、验证步骤、受限恢复方案、内省报告”输出，并明确哪些信息仍然缺失。
一份结构化故障分析，包含循环原因假设、验证方法、低风险恢复建议和可复盘的内省总结。
代理在执行任务时调用外部API失败，错误信息不完整。请设计一个自调试流程：先整理已知症状，再列出最可能的3个原因，给出不依赖高风险操作的恢复步骤，并输出最终诊断报告模板。
一个面向API故障的调试流程，覆盖症状归纳、根因优先级、受限恢复步骤和标准化报告模板。
基于以下故障记录，为AI代理生成内省报告：任务目标偏离、记忆状态可能污染、最终输出与用户意图不一致。请说明代理在哪些决策点可能出错、哪些保护机制缺失，以及后续如何监控同类问题。
一份聚焦决策失误与防护缺口的内省报告，并附带后续监控与改进建议。
当智能体运行反复失败、消耗令牌却无进展、在相同工具上循环或偏离预期任务时，使用此技能。
这是一个工作流技能，而非隐藏运行时。它教会智能体在升级给人类之前，系统性地自我调试。
激活此技能用于：
请勿将此技能作为以下情况的主要来源：
verification-loop在尝试恢复之前，精确记录失败信息。
捕获内容：
最小捕获模板：
## 失败捕获
- 会话/任务：
- 进行中的目标：
- 错误：
- 最后成功的步骤：
- 最后失败的工具/命令：
- 观察到的重复模式：
- 需验证的环境假设：
在更改任何内容之前，将失败与已知模式匹配。
| 模式 | 可能原因 | 检查 |
|---|---|---|
| 最大工具调用/重复相同命令 | 循环或无退出观察路径 | 检查最后 N 次工具调用是否存在重复 |
| 上下文溢出/推理能力下降 | 无界笔记、重复计划、过大日志 | 检查近期上下文是否存在重复和低信号批量内容 |
ECONNREFUSED / 超时 | 服务不可用或端口错误 | 验证服务健康状态、URL 和端口假设 |
429 / 配额耗尽 | 重试风暴或缺少退避 | 统计重复调用次数并检查重试间隔 |
| 写入后文件缺失/差异过时 | 竞态、工作目录错误或分支漂移 | 重新检查路径、工作目录、git 状态和实际文件是否存在 |
| “修复”后测试仍然失败 | 假设错误 | 隔离确切失败的测试并重新推导错误 |
诊断问题：
使用改变诊断面的最小操作进行恢复。
安全恢复操作：
不要声称不支持的自动修复操作，如“重置智能体状态”或“更新框架配置”，除非你正在当前环境中通过真实工具实际执行这些操作。
受限恢复检查清单：
## 恢复操作
- 选择的诊断方式：
- 采取的最小操作：
- 为何此操作安全：
- 哪些证据能证明修复生效：
以一份使恢复过程对下一个智能体或人类清晰可读的报告结束。
## 代理自调试报告
- 会话/任务：
- 失败原因：
- 根本原因：
- 恢复措施：
- 结果：成功 | 部分成功 | 受阻
- Token/时间消耗风险：
- 是否需要后续跟进：
- 后续需编码的预防性变更：
按顺序优先选择以下干预措施：
错误模式：
正确模式：
verification-loop。continuous-learning-v2。council。workspace-surface-audit。当此技能激活时，不要仅以“我已修复”结束。
始终提供：
帮助 Swift 开发者实现基于 Actor 的线程安全内存与文件持久化方案
帮助开发者定位并调试 AI 代理的行为、调用链与异常问题