用途
sparc-refine 覆盖 SPARC 方法论的最后两个阶段:Phase 4 Refinement(精化)与 Phase 5 Completion(完成)。它适用于架构阶段已完成并通过其门禁之后,把功能从「已实现」推进到「可发布」。
主要能力
Phase 4 — Refinement
- 检索先前产物:调用 mcp__plugin_ruflo-core_ruflo__memory_search,命名空间 sparc-phases,按功能 slug 查询,加载规格(验收标准)、伪代码与架构。
- 检索阶段状态:调用 mcp__plugin_ruflo-core_ruflo__memory_search,命名空间 sparc-state,确认处于 Phase 4。
- 代码审查,对照以下维度:
- 规格符合性:每条验收标准是否有对应代码路径
- 架构遵循:模块是否遵守既定边界与依赖规则
- 伪代码一致性:实现是否匹配设计的算法
- 代码质量:命名约定、单一职责、错误处理、无死代码
- 将发现记录为审查评论
- 测试覆盖分析:
- 运行现有测试并测量覆盖率
- 找出未覆盖的验收标准
- 补写缺失测试:每个公共函数的单元测试、跨模块交互的集成测试、规格中每个边界情况的边界测试
- 新代码目标覆盖率 >= 80%
- 性能验证(若规格含性能约束):对伪代码中识别的关键路径做性能剖析,将实测与约束阈值对比,未达标则优化。
- 迭代:重复步骤 3-5,直到所有验收标准都有通过测试、代码审查无严重或高严重度问题、覆盖率达标、性能约束满足。
- 存储精化产物:调用 mcp__plugin_ruflo-core_ruflo__memory_store,命名空间 sparc-phases,键 refine-{feature-slug},值包含 status、reviewFindings、coveragePercent、performanceResults、iterations。
- 记录轨迹步骤:调用 mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-step,附精化摘要。
Phase 5 — Completion
- 全量回归:运行完整测试套件,确认精化改动未引入回归。
- 可追溯矩阵:将每条验收标准映射到验证它的测试、实现它的代码文件、当前通过/失败状态。
- 文档:从代码注释与类型定义生成 API 文档,为关键公共接口编写用法示例,更新受改动影响的既有文档。
- 部署就绪清单:所有测试通过、文档完整、数据库迁移已准备(如适用)、配置变更已记录、功能开关已配置(如适用)、回滚方案已定义、安全审查完成(无密钥泄露、输入已验证)。
- 存储完成产物:调用 mcp__plugin_ruflo-core_ruflo__memory_store,命名空间 sparc-phases,键 complete-{feature-slug},值包含 status、traceabilityMatrix、documentationFiles、deploymentChecklist、regressionResult。
- 结束轨迹:调用 mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-end,附完整 SPARC 周期摘要。
- 训练神经模式:调用 mcp__plugin_ruflo-core_ruflo__neural_train,用成功的 SPARC 周期数据改进未来预测。
- 存储学习到的模式:调用 mcp__plugin_ruflo-core_ruflo__memory_store,命名空间 patterns,键 sparc-{feature-slug},值总结有效做法、各阶段耗时与常见阻塞。
- 呈现完成报告:展示可追溯矩阵、部署清单与最终状态,并建议运行 /sparc advance 通过最终门禁,或 /sparc report 获取完整方法论报告。
使用方式
在架构阶段完成并通过门禁后调用本技能。技能通过 MCP 工具(memory_search、memory_store、hooks_intelligence_trajectory-step、hooks_intelligence_trajectory-end、neural_train)读写记忆与轨迹,并输出结构化的精化与完成报告。
输出格式
报告分为两部分:
Refinement 部分包含代码审查摘要(严重/高/中问题数、已解决数)、测试覆盖率(总体、新代码、验收标准覆盖数)、性能对照表(约束、目标、实测、状态)。
Completion 部分包含可追溯矩阵(AC、测试、代码、状态)、部署清单勾选项。
结尾提示:SPARC 工作流完成,运行 /sparc report 获取完整方法论报告。
适用场景
适用于采用 SPARC 方法论、需要系统化收尾的功能开发流程,尤其是要求代码审查、测试覆盖、性能验证、文档与部署就绪检查一并完成的场景。
限制
本技能依赖 ruvnet/ruflo 提供的 MCP 工具与记忆命名空间;具体安装方式、收费与平台支持信息暂未提供。