SuperAPI AI 工具集

sparc-implement

编程与开发

查看项目

更新于 10-15 14:56

技能介绍

用途

sparc-implement 用于执行 SPARC 方法论的第 2 阶段(Pseudocode,伪代码)和第 3 阶段(Architecture,架构)。这两个阶段被放在一起处理,因为算法设计会影响模块边界,模块边界也会反过来影响算法设计。该技能应在 Specification(规格说明)阶段完成并通过其门禁之后使用。

主要能力

  • 检索规格:通过 mcp__plugin_ruflo-core_ruflo__memory_search 在 sparc-phases 命名空间中查询该功能的规格,提取需求、验收标准、约束和边界情况。
  • 检索阶段状态:通过同一工具在 sparc-state 命名空间中确认当前处于第 2 或第 3 阶段。
  • 搜索架构模式:通过 mcp__plugin_ruflo-core_ruflo__neural_predict 根据功能描述查找过往项目中的相关架构决策。
  • 第 2 阶段——伪代码设计:为每条验收标准编写与语言无关的伪代码;定义带类型标注的核心数据结构;映射控制流,包括正常路径、每个边界情况的错误/异常路径,以及适用时的并发访问处理;标注关键路径的算法复杂度(时间与空间);将伪代码产物存入 sparc-phases 命名空间,键为 pseudo-{feature-slug},值为包含 status、algorithms、dataStructures、controlFlow、complexity 的对象。
  • 第 3 阶段——架构设计:按 DDD 模式定义限界上下文与聚合根,识别实体边界与值对象、定义聚合不变量、映射领域事件;设计 API 契约,包括 TypeScript 接口形式的请求/响应模式、错误响应码与格式、适用时的版本策略;规划模块边界,包括目录结构、依赖方向规则(禁止循环依赖)、公开与内部接口;明确基础设施关注点,包括持久化策略(数据库、缓存、文件)、消息模式(同步、异步、事件驱动)、配置与环境要求;将架构产物存入 sparc-phases 命名空间,键为 arch-{feature-slug},值为包含 status、boundedContexts、apiContracts、moduleBoundaries、infrastructure 的对象。
  • 更新阶段状态:通过 mcp__plugin_ruflo-core_ruflo__memory_store 在 sparc-state 命名空间中将当前阶段更新为 3(Architecture),并记录两个产物。
  • 记录轨迹步骤:通过 mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-step 记录架构摘要。
  • 开始实现:若用户确认,则按已定义的模块边界创建文件,先实现接口与类型,再按伪代码实现核心逻辑,同时编写单元测试(尽可能采用 TDD),运行测试以验证验收标准。
  • 展示架构:显示架构决策记录,并建议运行 /sparc advance 以通过第 3 阶段门禁。

使用方式

该技能以步骤化流程执行:先检索规格与阶段状态,再搜索架构模式,然后依次完成第 2 阶段伪代码设计与第 3 阶段架构设计,将产物写入记忆,更新阶段状态并记录轨迹,最后在用户确认后进入实现。输出格式包含伪代码部分(核心算法、复杂度、数据结构)与架构部分(限界上下文、API 契约、模块结构、基础设施),并以提示运行 /sparc advance 通过门禁结束。

适用场景

适用于已通过 Specification 阶段门禁、需要先设计算法与架构再编写生产代码的功能开发流程。

限制

资料未提供该技能的具体收费、价格、平台支持范围或效果保证等信息。