用途
sparc-spec 用于运行 SPARC 方法论的第 1 阶段——规格说明阶段,目标是在写任何代码之前,明确「必须构建什么」以及「如何衡量成功」。它适用于启动一个新功能或新项目、需要先进行结构化需求收集的场景。该阶段产出的基础规格,是后续所有阶段(伪代码、架构、精化、完成)的构建依据。
主要能力
该技能围绕需求收集与规格固化展开,具体包括:
- 初始化阶段追踪:调用 mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-start,并传入元数据 { "phase": "specification", "feature": "$ARGUMENTS" }。
- 检查既有工作:调用 mcp__plugin_ruflo-core_ruflo__memory_search,在命名空间 sparc-state 中按功能查询是否已存在 SPARC 工作流;若存在则取回已有产物,若不存在则以第 1 阶段初始化状态。
- 搜索相似模式:调用 mcp__plugin_ruflo-core_ruflo__neural_predict,用功能描述查找相关的历史规格与已学习模式。
- 收集需求:分析功能描述与代码库,识别功能需求(面向用户的行为)、非功能需求(性能目标、安全约束、可扩展性需求)、集成点(受影响的现有系统或 API)、数据需求(创建、读取、更新或删除的数据)。
- 定义验收标准:以 Given/When/Then 格式写出至少 3 条具体、可测试的验收标准(AC-1、AC-2、AC-3)。
- 识别约束:记录性能约束(延迟、吞吐量、资源限制)、安全约束(认证、授权、数据敏感性)、兼容性约束(浏览器支持、API 版本、向后兼容)、基础设施约束(部署环境、依赖)。
- 映射边界情况:列出至少 3 个边界情况或失败场景,例如无效输入、并发访问、外部依赖失败时的行为。
- 存储规格:调用 mcp__plugin_ruflo-core_ruflo__memory_store,命名空间为 sparc-phases,键为 spec-{feature-slug},值为包含 { status: "complete", requirements, acceptanceCriteria, constraints, edgeCases, integrationPoints } 的 JSON。
- 更新阶段状态:再次调用 memory_store,命名空间为 sparc-state,键为 current-phase-{feature-slug},值为更新后的状态,其产物列表包含该规格键。
- 记录轨迹步骤:调用 mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-step,写入规格摘要。
- 展示规格:向用户显示完整规格文档与摘要表,并建议运行 /sparc advance 通过门禁、进入伪代码阶段。
使用方式
该技能按固定步骤顺序执行:先初始化阶段追踪,再检查是否已有 SPARC 工作流,接着搜索相似模式,然后依次完成需求收集、验收标准定义、约束识别、边界情况映射,最后将规格与阶段状态写入记忆存储、记录轨迹步骤并展示结果。执行完成后,用户可运行 /sparc advance 通过门禁检查并进入下一阶段。
输出格式为结构化文档,包含以下部分:
- 标题:Specification: {Feature Name}
- Requirements:分为 Functional(FR-1、FR-2……)与 Non-Functional(NFR-1……)
- Acceptance Criteria:AC-1、AC-2、AC-3,均为 Given/When/Then 格式
- Constraints:Performance、Security、Compatibility 等
- Edge Cases:EC-1、EC-2、EC-3
- Integration Points:IP-1 等
- 结尾提示:Phase 1 complete. Run
/sparc advanceto pass the gate check.
适用场景
适用于启动新功能或新项目、需要在编码前进行结构化需求收集的场合。它产出的规格是后续伪代码、架构、精化与完成阶段的基础。
限制
资料未提供该技能的收费、价格、平台支持范围、性能效果等具体信息,暂未提供。