SuperAPI AI 工具集

improvement-workflow

智能体与模型

查看项目

更新于 10-15 10:02

技能介绍

用途

improvement-workflow 为 Claude Code 技能编排完整的持续改进周期,把评审发现转化为已应用的改进和经过验证的增强。其目标是实现端到端的技能改进:从评审到验证过的增强。

主要能力

该工作流由 5 个组件技能构成:

  • review-multi:多维度综合评审(识别问题)
  • analysis:跨发现项的模式分析(理解系统性问题)
  • best-practices-learner:提取经验(捕获洞见)
  • skill-updater:应用改进(实施变更)
  • skill-validator:验证改进(确保质量得以保持)

工作流模式为带反馈回路的顺序流水线,最终产出经过系统改进、增强经验证且经验被捕获的技能。

使用方式

工作流分为 6 个步骤:

  1. 综合评审(review-multi):运行 review-multi 综合模式(全部 5 项操作),输出总体评分与等级、各维度评分、按优先级排序的改进建议、已识别的问题与反模式。耗时 1.5-2.5 小时。
  2. 模式分析(analysis):使用 analysis 操作 5(模式识别),审视第 1 步的发现,识别反复出现的主题(若评审多个技能),理解根因,按影响排序。输出模式分析(系统性问题与一次性问题)、根因理解、按影响排序的改进项。耗时 45-90 分钟。
  3. 提取经验(best-practices-learner):使用 best-practices-learner 操作 1-2,从评审发现中提取模式,记录哪些有效/无效,捕获用于指南的洞见。输出已记录的模式、经验日志、用于指南更新的洞见。耗时 30-60 分钟。
  4. 应用改进(skill-updater):使用 skill-updater 工作流,规划更新(按建议优先级排序)、备份技能、逐项应用变更、测试每项变更。输出已应用改进的更新技能、变更文档、版本更新。耗时 1-4 小时(视改进数量而定)。
  5. 验证改进(skill-validator + review-multi):运行 skill-validator(确保仍通过最低标准),重新运行 review-multi(对比前后评分),验证改进达成目标,记录影响。输出验证结果(通过/失败)、前后评分对比、影响度量、回归检查。耗时 30-60 分钟。
  6. 更新指南(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 次迭代后收益递减;优先聚焦影响最大的改进。

最佳实践

  1. 先评审再改进:变更前始终进行综合评审,充分理解现状可避免修错东西。
  2. 按影响排序:优先应用高影响改进,以最小投入获得最大收益。
  3. 一次一项改进:逐项应用并验证每项变更,防止错误叠加,识别真正起作用的改动。
  4. 度量影响:客观对比前后评分,以数据驱动理解有效性。
  5. 捕获经验:记录有效做法以供未来应用,经验会在改进中不断累积。

典型改进项

  • 添加快速参考(用户体验)
  • 增强示例(清晰度)
  • 细化验证标准(具体性)
  • 添加错误处理(完整性)
  • 改进集成文档(工作流技能)

限制

资料未提供该工作流的收费、价格、平台支持范围等具体信息。完整改进周期总耗时约 5-9 小时,且 2-3 次迭代后收益递减。