Agent Skills
返回列表
智能体失败复盘师

智能体失败复盘师

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 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 工程师
  • 需要从失败案例中沉淀团队避坑清单的技术负责人
  • 需要分析智能体翻车原因并给出复盘报告的技术博主