智能体失败复盘师
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的说明,将 @user_af163eaa/z-agent-failure-postmortem 安装到当前 AI 助手中。
技能介绍
解决的问题
智能体失败后,开发者常急于补救而非分析原因,导致同样的问题重复发生。本技能通过事后复盘,帮助你搞清楚为什么,再给出下次避坑清单。
核心能力与关键步骤
- F1 时间线还原:让用户贴上下文/日志,还原“哪一步开始偏”。
- F2 根因分类:按
references/框架.md的6类归因:模型局限/提示缺陷/上下文丢失/工具故障/目标错配/外部数据错。 - F3 影响评估:错在哪、波及什么。
- F4 规避清单:每条根因→1条可执行规避(含该用哪个技能防)。
适用边界与注意点
- 复盘不替用户甩锅给模型,客观归因。
- 规避清单必须可执行,不得“下次注意”空话。
- 不擅自重跑/修改任何文件或对话。
使用场景
- 长对话智能体中途输出漂移,需要还原时间线并判断是否上下文截断
- Agent 执行多步任务后产出错误,需要分类根因并生成下次避坑清单
- 模型输出内容与用户目标不符,需要评估影响并给出对应规避措施
- 外部数据源返回异常导致 Agent 失败,需要客观归因而非直接甩锅模型
适合人员
- 需要调试复杂 Agent 工作流、定位失败根因的后端工程师
- 负责模型效果评估、需要输出可执行改进项的 AI 工程师
- 需要从失败案例中沉淀团队避坑清单的技术负责人
- 需要分析智能体翻车原因并给出复盘报告的技术博主