← Playbook 索引
Playbook阶段 10可泛化原则
单 Case 根因修复闭环（Single-Case Root-Cause Fix）
质量
把一个失败从“这次跑绿了”修到根因被消除：可以稳定复现、责任层明确、修复范围可解释、重复运行通过、相关回归无新增失败，并留下防止再犯的资产。
什么时候拿出来用
- Eval、UAT 或生产反馈出现一个可以独立复现的失败
- 同一个症状已经被打过补丁，但仍然随机或换种问法就复发
开始前先拿到
- 这条 Case 自己的验收标准
- 真实 Trace、输入和最终输出
- 可以单独重放该 Case 的验证通道
操作主线
怎么推进
公开的是判断与动作骨架。客户数据、私有模板和内部示例不在其中。
- 01
稳定复现并分层
确认失败原子，判断问题在数据、工具、契约、模型、输出还是权限层。
- 02
证实根因
用 Probe、日志或最小诊断证明假设；连续猜错就补事实，不继续叠补丁。
- 03
做最小根因修复
改造成问题的那一层，不在下游遮症状，也不扩大到无关重构。
- 04
独立验证并沉淀
稳定复跑、相关回归、部署真相检查完成后，再写入 Ledger、Case 或代码护栏。
会留下什么
- 缺陷分诊与根因记录
- 最小修复和验证证据
- 回归 Case 或确定性护栏
过关前再看一遍
- 根因有证据而不是猜测
- 单 Case 稳定通过且无相关回归
- 独立验证完成，经验有明确去向
Exit Gate · 放行条件
单 Case 按责任层修复并稳定复跑通过
容易做错的地方
- 修到一次通过就结束
- 把上游缺数与我方参数错误混为一谈
- 由修复者自报 PASS 代替独立复核
这套方法怎么落到你的项目
这是我们交付生产级 AI Agent 的公开、脱敏方法骨架。真正落地时，从 AI Agent 生产就绪审查与路线图 入手，或先用 生产上线前深检 定位薄弱环节。