用途
improvement-workflow 为 Claude Code 技能编排完整的持续改进周期,把评审发现转化为已应用的改进和经过验证的增强。其目标是实现端到端的技能改进:从评审到验证过的增强。
主要能力
该工作流由 5 个组件技能构成:
- review-multi:多维度综合评审(识别问题)
- analysis:跨发现项的模式分析(理解系统性问题)
- best-practices-learner:提取经验(捕获洞见)
- skill-updater:应用改进(实施变更)
- skill-validator:验证改进(确保质量得以保持)
工作流模式为带反馈回路的顺序流水线,最终产出经过系统改进、增强经验证且经验被捕获的技能。
使用方式
工作流分为 6 个步骤:
- 综合评审(review-multi):运行 review-multi 综合模式(全部 5 项操作),输出总体评分与等级、各维度评分、按优先级排序的改进建议、已识别的问题与反模式。耗时 1.5-2.5 小时。
- 模式分析(analysis):使用 analysis 操作 5(模式识别),审视第 1 步的发现,识别反复出现的主题(若评审多个技能),理解根因,按影响排序。输出模式分析(系统性问题与一次性问题)、根因理解、按影响排序的改进项。耗时 45-90 分钟。
- 提取经验(best-practices-learner):使用 best-practices-learner 操作 1-2,从评审发现中提取模式,记录哪些有效/无效,捕获用于指南的洞见。输出已记录的模式、经验日志、用于指南更新的洞见。耗时 30-60 分钟。
- 应用改进(skill-updater):使用 skill-updater 工作流,规划更新(按建议优先级排序)、备份技能、逐项应用变更、测试每项变更。输出已应用改进的更新技能、变更文档、版本更新。耗时 1-4 小时(视改进数量而定)。
- 验证改进(skill-validator + review-multi):运行 skill-validator(确保仍通过最低标准),重新运行 review-multi(对比前后评分),验证改进达成目标,记录影响。输出验证结果(通过/失败)、前后评分对比、影响度量、回归检查。耗时 30-60 分钟。
- 更新指南(best-practices-learner):使用 best-practices-learner 操作 3,用新模式更新 common-patterns.md,必要时更新模板,将经验传播到未来技能。输出更新后的指南、改进的模板、增强的生态知识。耗时 20-40 分钟。
工作流模式示意:
review-multi → 识别改进 ↓ analysis → 理解模式 ↓ best-practices-learner → 提取经验 ↓ skill-updater → 应用变更 ↓ validate → 度量影响 ↓ 更新指南 → 反哺生态
适用场景
- 持续改进迭代(让好技能更好)
- 落实评审建议(系统化实施)
- 部署后增强(v1.0 → v1.1)
- 多技能改进(保持一致流程)
- 学习驱动开发(捕获并应用洞见)
工作流后的迭代决策
完成工作流后:
- 若评分显著提升(≥0.5 分):改进有效,记录成功,将类似改进应用到其他技能。
- 若评分略有提升(<0.5 分):影响较小,评估投入是否值得,考虑其他改进方向。
- 若评分不变或下降:改进无效或造成回归,审视问题所在,若回归则回滚变更,尝试不同方法。
迭代:可再次运行工作流以进一步改进;2-3 次迭代后收益递减;优先聚焦影响最大的改进。
最佳实践
- 先评审再改进:变更前始终进行综合评审,充分理解现状可避免修错东西。
- 按影响排序:优先应用高影响改进,以最小投入获得最大收益。
- 一次一项改进:逐项应用并验证每项变更,防止错误叠加,识别真正起作用的改动。
- 度量影响:客观对比前后评分,以数据驱动理解有效性。
- 捕获经验:记录有效做法以供未来应用,经验会在改进中不断累积。
典型改进项
- 添加快速参考(用户体验)
- 增强示例(清晰度)
- 细化验证标准(具体性)
- 添加错误处理(完整性)
- 改进集成文档(工作流技能)
限制
资料未提供该工作流的收费、价格、平台支持范围等具体信息。完整改进周期总耗时约 5-9 小时,且 2-3 次迭代后收益递减。