| name | root-review |
| description | 通用复盘与根因分析。适用于任何场景(开发需求、个人生活、兴趣爱好、项目管理),从问题出发,归类分析,找到根本原因,产出可执行的改进方案。当用户提到复盘、反思、总结经验、分析问题、找根因、回顾、改进、文档整理、目录重组时触发此 skill。即使用户只是说'最近状态不对'、'这次搞砸了'、'总结一下这个项目'、'文档太乱了'也应触发。 |
root-review — 复盘与根因分析
从问题出发,找到根本原因,产出可执行的改进方案。适用于任何场景——开发需求、项目管理、个人生活、兴趣爱好。
核心理念:复盘不是列问题清单,而是穿透表象找到根因。解决了根因,一堆表面问题同时消失。
触发时机
- 手动:
/root-review
- 场景触发:需求阶段完成后、发现问题想分析时、需要总结经验时、文档混乱需要整理时
输入
用户提供以下一项或多项:
- 遇到的问题 / 不满 / 观察
- 想要的效果 / 理想状态
- 相关材料(文档、数据、目录路径)
- 复盘范围(某个需求、某段时间、某个事件)
Phase 1: 问题收集
不急着分析,先把问题都摊开来。
1a. 提取问题
从用户输入中提取所有问题和不满。如果用户提供了目录/文档路径,主动读取并发现问题。
每个问题用一句话描述,附带具体表现:
问题:<一句话>
表现:<具体证据/例子>
1b. 确认预期
对每个问题,追问"理想状态是什么":
- 用户说"文档太乱" → 理想状态:"文档有清晰目录,按阶段组织,找东西不超过30秒"
- 用户说"总是加班" → 理想状态:"按时下班,工作在预期内完成"
如果用户已经描述了理想效果,直接提取;如果没有,主动问。
1c. 确认清单
把问题清单 + 理想状态展示给用户确认:
Phase 2: 归类分析(Fishbone)
把散乱的问题归入维度,看见结构。
按以下维度对问题归类。不是所有维度都会有问题,空的跳过:
| 维度 | 含义 | 例子 |
|---|
| 人 | 自己或他人的行为、决策、沟通 | "产品没说清楚需求"、"我没及时同步进度" |
| 方法/流程 | 做事的方式、步骤、工具 | "没有做路径分解就直接写代码"、"没有固定复盘节奏" |
| 环境/外部 | 不可控的外部因素 | "第三方接口突然限流"、"上游需求频繁变更" |
| 信息/资源 | 获取了什么、缺了什么 | "没读完代码就开始改"、"缺少测试环境" |
| 认知/心理 | 预期偏差、认知盲区、情绪影响 | "低估了复杂度"、"焦虑导致赶工" |
归类后,标注哪些是"可控"的(自己能改变),哪些是"外部"的(只能应对)。
重点放在可控因素上——这是后续找根因的重点。
Phase 3: 根因挖掘(5 Whys)
这是整个复盘最关键的一步。表面问题只是症状,根因才是病灶。
对 Phase 2 中优先级最高的 2-3 个可控问题,逐个做 5 Whys 分析:
问题:文档散落在多个文件里,找不到关键信息
→ 为什么?写文档时没有统一模板
→ 为什么?当时没有定义文档规范
→ 为什么?觉得"先做完再整理"
→ 为什么?低估了文档混乱对后续效率的影响
→ 根因:缺乏"文档是开发过程的一部分"的认知
追问技巧:
- 每次问"为什么"时,聚焦于可控的、具体的原因
- 如果答案变成"因为xxx不行"(推卸给外部),引导回自己能做什么
- 到达"认知层面"或"流程缺失层面"时,通常就是根因了
- 不一定刚好 5 次,3-7 次都正常
根因的判断标准:
- 解决它之后,多个表面问题同时消失
- 它属于自己可以改变的范畴
- 它是"做法"或"认知"层面的,不是"态度"层面的("不够努力"不是根因)
Phase 4: 行动方案
根因找到了,方案要具体到"下次遇到同样情况,我会做什么不同的事"。
4a. 针对根因出方案
每个根因对应 1-2 个具体行动:
| 根因 | 行动 | 衡量标准 |
|------|------|---------|
| 缺乏文档即开发的认知 | 每个需求开始时先建 00-路径分解.md | 是否有路径分解文件 |
行动的标准:
- 可执行:是具体动作,不是态度宣言("更认真" ✗ → "每天 standup 前花5分钟检查" ✓)
- 可验证:能判断是否做了
- 限制数量:每次复盘最多 3 个行动项,否则都会落空
4b. 领域特定动作(按需)
如果复盘的是开发需求,可能涉及:
- 文档重组:git mv 文件、创建 archive、更新 MANIFEST
- 经验沉淀:更新 memory/long/
- 流程改进:更新 skills 或 rules
如果复盘的是个人生活/兴趣:
- 习惯调整:记录到 todo 或日历
- 认知更新:记录到 memory/long/ 的对应领域文件
4c. 确认与沉淀
向用户展示完整的复盘结果:
- 问题全景:问题清单 + 归类 + 优先级
- 根因链:每个关键问题的 5 Whys 链
- 行动方案:根因 → 具体行动 → 衡量标准
- 需要他人配合的事项(如有)
等用户确认后,执行相关改动(如果有文件操作的话)。
质量标准
常见陷阱
- 问题即方案:用户说"需要加个监控"——这是方案不是问题,追问"为什么需要监控?出了什么事?"
- 归因外部化:所有原因都是别人的问题——引导回"在这个约束下,我能做什么不同"
- 行动太泛:保持"更加注意"——不是行动,追问"具体做什么?"
- 贪多:一次提 8 个改进——砍到 3 个最关键的