| name | improve-retro |
| description | 问题记录与定期总结提炼。Use when 同一问题反复出现、Milestone 结束、或需要把踩过的坑提炼成可复用规则/新 Skill 时。也适用于定期复盘、更新验收标准或拆分策略、沉淀方法论的场景。 |
Improve-Retro:持续改进
概述
把执行中反复出现的问题自动记录下来,定期总结,提炼成可复用规则、新 Skill 或方法论更新,形成闭环。
核心原则: 同样的坑不踩第二次。改进必须沉淀为「下次会自动生效」的东西(规则/Skill/标准),而非一次性口头总结。
何时使用
- 同一问题反复出现 ≥ 2 次
- CI/测试失败且非显而易见原因
- Review 被退回 ≥ 2 次
- Milestone 结束 / 每完成 10 个 Issue / 每周固定时间 → 定期总结
问题自动记录
满足触发条件时追加到 docs/issues-log.md,格式:
### [日期]: 问题标题
- **出现位置**: #3, #5
- **问题**: 简述
- **最终解法**: 简述
- **可复用规则**: 提炼出的规则
定期总结提炼流程
- 读取本期所有问题记录
- 分类:重复出现的 vs 一次性的
- 提炼:哪些固化为 Skill?哪些更新验收标准?哪些调整拆分策略?
- 输出改进清单,逐条更新到对应文档/Skill,并记入
docs/improvements/CHANGELOG.md
产出
docs/issues-log.md 问题记录
- 改进清单 +
docs/improvements/CHANGELOG.md 条目
- 新增/更新的 Skill 或验收标准
提炼为新 Skill 时
参考 reference/SKILL-writing-guide.md 的写作规范与 reference/vendored-skills/superpowers/skills/writing-skills。
常见错误
- 总结停在口头 → 下次照样犯。必须落成规则/Skill/标准更新。
- 重复与一次性不分 → 把偶发问题也固化成规则,增加负担。先分类再提炼。
参考
- 记录文件:
docs/issues-log.md、docs/improvements/CHANGELOG.md
- 上一步:
skills/observe-session/SKILL.md
- 写 Skill 规范:
reference/SKILL-writing-guide.md
- 方法论出处:唯一真源
docs/AI 编程方法论 v1.2 — 可操作版.md 第五章(Improve)