SuperAPI AI 工具集

sparc-refine

编程与开发

查看项目

更新于 10-15 14:56

技能介绍

用途

sparc-refine 覆盖 SPARC 方法论的最后两个阶段:Phase 4 Refinement(精化)与 Phase 5 Completion(完成)。它适用于架构阶段已完成并通过其门禁之后,把功能从「已实现」推进到「可发布」。

主要能力

Phase 4 — Refinement

  1. 检索先前产物:调用 mcp__plugin_ruflo-core_ruflo__memory_search,命名空间 sparc-phases,按功能 slug 查询,加载规格(验收标准)、伪代码与架构。
  2. 检索阶段状态:调用 mcp__plugin_ruflo-core_ruflo__memory_search,命名空间 sparc-state,确认处于 Phase 4。
  3. 代码审查,对照以下维度:
    • 规格符合性:每条验收标准是否有对应代码路径
    • 架构遵循:模块是否遵守既定边界与依赖规则
    • 伪代码一致性:实现是否匹配设计的算法
    • 代码质量:命名约定、单一职责、错误处理、无死代码
    • 将发现记录为审查评论
  4. 测试覆盖分析:
    • 运行现有测试并测量覆盖率
    • 找出未覆盖的验收标准
    • 补写缺失测试:每个公共函数的单元测试、跨模块交互的集成测试、规格中每个边界情况的边界测试
    • 新代码目标覆盖率 >= 80%
  5. 性能验证(若规格含性能约束):对伪代码中识别的关键路径做性能剖析,将实测与约束阈值对比,未达标则优化。
  6. 迭代:重复步骤 3-5,直到所有验收标准都有通过测试、代码审查无严重或高严重度问题、覆盖率达标、性能约束满足。
  7. 存储精化产物:调用 mcp__plugin_ruflo-core_ruflo__memory_store,命名空间 sparc-phases,键 refine-{feature-slug},值包含 status、reviewFindings、coveragePercent、performanceResults、iterations。
  8. 记录轨迹步骤:调用 mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-step,附精化摘要。

Phase 5 — Completion

  1. 全量回归:运行完整测试套件,确认精化改动未引入回归。
  2. 可追溯矩阵:将每条验收标准映射到验证它的测试、实现它的代码文件、当前通过/失败状态。
  3. 文档:从代码注释与类型定义生成 API 文档,为关键公共接口编写用法示例,更新受改动影响的既有文档。
  4. 部署就绪清单:所有测试通过、文档完整、数据库迁移已准备(如适用)、配置变更已记录、功能开关已配置(如适用)、回滚方案已定义、安全审查完成(无密钥泄露、输入已验证)。
  5. 存储完成产物:调用 mcp__plugin_ruflo-core_ruflo__memory_store,命名空间 sparc-phases,键 complete-{feature-slug},值包含 status、traceabilityMatrix、documentationFiles、deploymentChecklist、regressionResult。
  6. 结束轨迹:调用 mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-end,附完整 SPARC 周期摘要。
  7. 训练神经模式:调用 mcp__plugin_ruflo-core_ruflo__neural_train,用成功的 SPARC 周期数据改进未来预测。
  8. 存储学习到的模式:调用 mcp__plugin_ruflo-core_ruflo__memory_store,命名空间 patterns,键 sparc-{feature-slug},值总结有效做法、各阶段耗时与常见阻塞。
  9. 呈现完成报告:展示可追溯矩阵、部署清单与最终状态,并建议运行 /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 工具与记忆命名空间;具体安装方式、收费与平台支持信息暂未提供。