ruflo-sparc 实战用 SPARC Phase 2/3 技能完成伪代码设计与架构契约落地【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo本篇技术指南聚焦 ruflo-sparc 插件中的sparc-implement技能SKILL.md讲解如何按 SPARC 方法论执行 Pseudocode伪代码与 Architecture架构两个阶段并在门禁通过后进入实现。读完本文你将掌握如何基于 Specification 阶段的验收标准编写带复杂度标注的语言无关伪代码、如何用 DDD 边界上下文与 TypeScript 类型化 API 契约定义模块边界、如何把两份产物写入 AgentDB 命名空间并推进阶段状态以及如何用/sparc advance通过 Phase 3 门禁。一、技能定位SPARC 五阶段中的 Phase 2/3ruflo-sparc 是 ruflo 生态中的 SPARC 方法论编排插件见 README将特性开发拆分为五个带质量门禁的阶段每个阶段必须通过门禁检查才能进入下一阶段阶段名称门禁标准派生的 Agent1Specification≥ 3 条验收标准、约束、边界情况researcher2Pseudocode覆盖全部 AC、错误路径显式、复杂度已标注planner3Architecture约束全部被处理、类型化 API 契约、无循环依赖system-architect4Refinement全部 AC 有通过测试、评审通过、覆盖率 ≥ 80%codertester5Completion测试全绿、文档完整、部署清单已验证reviewersparc-implement技能同时覆盖 Phase 2 与 Phase 3因为二者紧密耦合算法设计伪代码会反过来约束模块边界模块边界也会修正算法方案。技能的 frontmatterallowed-tools明确授权了memory_store/memory_search/memory_retrieve、task_create/task_update/task_complete、hooks_intelligence_trajectory-step、neural_predict、workflow_create以及Bash / Read / Write / Edit文件能力——这意味着技能既负责设计也负责落地实现。二、使用前提Specification 阶段完成并通过门禁技能文档明确指出使用时机Specification 阶段完成后且其门禁已通过。在 ruflo 中这意味着在此之前已完成以下铺垫通过/sparc init feature初始化工作流创建 feature slug、在sparc-state写入current-phase-{slug}状态、在sparc-phases预置spec-{slug}占位详见 ruflo-sparc 命令文档通过/sparc-spec feature-description技能完成需求收集、至少 3 条 Given/When/Then 格式的验收标准AC、约束清单与边界情况清单并将产物以spec-{feature-slug}键存入sparc-phases命名空间见 sparc-spec/SKILL.md通过/sparc advance让 Phase 1 门禁判定通过校验 AC 数量、约束与边界情况是否齐备阶段推进到 2。从 sparc-orchestrator Agent 定义 可以确认门禁协议的固定流程检索sparc-phases中的阶段产物 → 逐条评估门禁标准任一不通过即整体失败→ 结果写入sparc-gates→ 失败则返回当前阶段并给出改进建议成功才推进阶段计数并通知用户。三、执行前的三条检索步骤让设计建立在前序证据之上sparc-implement的第 13 步不是直接写代码而是先检索证据确保设计可追溯检索规格调用mcp__plugin_ruflo-core_ruflo__memory_search命名空间sparc-phases查询该特性的 spec抽取需求、验收标准、约束与边界情况——伪代码必须逐条满足 AC这是 Phase 2 门禁的核心检索阶段状态调用memory_search命名空间sparc-state确认当前处于 Phase 2 或 Phase 3防止阶段漂移orchestrator 文档强调任何阶段操作前先取回当前状态检索历史模式调用mcp__plugin_ruflo-core_ruflo__neural_predict用特性描述预测过去项目中相关的架构决策。这是 ruflo 智能体自我学习闭环的一环——sparc-refine 技能 会在整轮 SPARC 结束时用neural_train回灌成功数据而patterns命名空间注意是复数与 ReasoningBank 的pattern保留命名空间不同存储跨特性的经验模式供后续neural_predict复用。四、Phase 2 伪代码设计先想清楚再动手Phase 2 的目标是在写生产代码之前完成算法与数据流设计。技能文档给出了 5 个子步骤全部必须落地为每条验收标准写语言无关伪代码不绑定具体编程语言保证可移植、可评审定义核心数据结构并带类型标注如{ field1: type, field2: type }绘制控制流必须覆盖三类路径Happy path正常路径每个边界情况的错误/异常路径如适用并发访问处理标注关键路径的算法复杂度时间与空间用于后续性能验证——sparc-refine 技能 的 Phase 4 会针对伪代码中标注的关键路径做 profiling比对规格中的性能约束阈值存储伪代码产物调用memory_store命名空间sparc-phases键pseudo-{feature-slug}值为 JSON 结构{ status: complete, algorithms: [...], dataStructures: [...], controlFlow: [...], complexity: {...} }Phase 2 门禁见 README 与 orchestrator 定义会校验伪代码是否覆盖规格中全部 AC、错误路径是否显式、复杂度是否已标注。五、Phase 3 架构设计DDD 边界、API 契约与模块规划Phase 3 在伪代码之上建立架构包含 5 个子步骤定义边界上下文与聚合根DDD 模式识别实体边界与值对象、定义聚合不变量aggregate invariants、映射领域事件。ruflo 中这一步与 ruflo-ddd 插件契约 直接对齐——该插件提供ddd-context/ddd-aggregate/ddd-validate三个技能把领域模型以分层节点 因果边的图结构存入 AgentDBddd-contexts命名空间orchestrator 在 Phase 3 会查询该命名空间复用已有领域模型设计 API 契约用 TypeScript 接口定义请求/响应 schema、错误响应码与格式如 400 校验失败 / 409 冲突 / 500 内部错误、适用时给出版本化策略规划模块边界目录结构、依赖方向规则禁止循环依赖——这是 Phase 3 门禁检查项之一、公开接口与内部接口的区分明确基础设施关注点持久化策略数据库/缓存/文件、消息模式同步/异步/事件驱动、配置与环境要求存储架构产物调用memory_store命名空间sparc-phases键arch-{feature-slug}值为{ status: complete, boundedContexts: [...], apiContracts: [...], moduleBoundaries: {...}, infrastructure: {...} }ruflo-sparc 的 ADR-0001 明确了 Phase 3 的能力归属架构阶段由ruflo-adr生成 ADR与ruflo-ddd边界上下文建模做深度支撑ruflo-sparc负责编排生命周期兄弟插件负责各阶段深水区工作。六、推进状态、记录轨迹并开始实现Phase 2/3 产物入库后技能要求连续执行三个动作更新阶段状态memory_store命名空间sparc-state将当前阶段更新为 3Architecture并记录两份产物键pseudo-{slug}、arch-{slug}记录轨迹步调用mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-step写入架构摘要——这与 sparc-spec 的trajectory-start、sparc-refine 的trajectory-end共同构成整轮 SPARC 的执行轨迹供后续智能体学习开始实现用户确认后按照既定模块边界创建文件先实现接口与类型再实现核心逻辑严格对应伪代码同时编写单元测试尽量 TDD最后运行测试验证 AC。实现阶段的产物规范在输出模板的 Module Structure 一节中有明确约定{feature}.types.ts接口与类型、{feature}.service.ts业务逻辑、{feature}.controller.tsHTTP 处理、{feature}.repository.ts数据访问、{feature}.test.ts测试。七、标准输出格式模板技能文档定义了完整的输出格式展示给用户的设计产物应遵循此结构# Pseudocode: {Feature Name} ## Core Algorithms ### Algorithm 1: {name} FUNCTION processRequest(input): VALIDATE input against schema IF invalid THEN THROW ValidationError result - TRANSFORM input STORE result RETURN result Complexity: O(n) time, O(1) space ## Data Structures - {StructName}: { field1: type, field2: type } --- # Architecture: {Feature Name} ## Bounded Contexts - {ContextName}: {description} - Aggregates: {list} - Events: {list} ## API Contracts ### POST /api/{resource} - Request: { field1: string, field2: number } - Response: { id: string, ...fields } - Errors: 400 (validation), 409 (conflict), 500 (internal) ## Module Structure src/{feature}/ {feature}.types.ts # Interfaces and types {feature}.service.ts # Business logic {feature}.controller.ts # HTTP handling {feature}.repository.ts # Data access {feature}.test.ts # Tests ## Infrastructure - Persistence: {strategy} - Caching: {strategy} - Events: {strategy} --- Phases 2-3 complete. Run /sparc advance to pass the gate check.八、门禁收口/sparc advance与可验证的契约设计产物呈现给用户后技能建议运行/sparc advance触发 Phase 3 门禁。根据 命令文档Phase 3 门禁会校验三条硬性标准架构是否处理了规格中的全部约束API 契约是否为类型化TypeScript 接口无循环依赖。门禁结果以gate-{phase}-{slug}-{timestamp}为键写入sparc-gates通过则sparc-state阶段递增并提示进入 Phase 4失败则gateAttempts递增并列出阻塞项与对应改进建议。除advance外命令还提供init、status含进度条[ ] Phase 3/5 — Architecture、phase phase-name支持spec/pseudo/arch/refine/complete别名与 1-5 数字向前跳跃会警告跳过门禁和report生成含追踪矩阵的完整方法论报告。这一整套契约并非无据可依插件根目录的 smoke.sh 以 11 项结构化检查作为契约即验证smoke-as-contract——包括 5 个阶段名齐备、3 个技能 1 个 Agent 1 个命令 frontmatter 有效、sparc-state/sparc-phases/sparc-gates三个命名空间被认领、phase-to-plugin 对齐表存在、ADR-0001 状态为 Accepted、以及技能allowed-tools无通配符越权。运行bash plugins/ruflo-sparc/scripts/smoke.sh期望输出 11 passed, 0 failed。整条链路确保设计有门禁、产物有存储、状态可追踪、契约可回归。九、关键要点回顾两阶段联动伪代码设计Phase 2与架构设计Phase 3强耦合sparc-implement技能一并执行产物分别以pseudo-{slug}与arch-{slug}键入库全程可追溯每个设计决策都锚定到 spec 的验收标准与约束通过sparc-state/sparc-phases/sparc-gates三个命名空间形成完整的阶段-产物-门禁证据链先接口后实现实现顺序固定为接口与类型 → 核心逻辑 → 测试与架构产物中的模块边界一一对应生态协作Phase 3 的 DDD 建模与 ADR 记录分别由 ruflo-ddd 与 ruflo-adr 承担深水区工作ADR-0001 将这种阶段到插件的对齐固化为契约验证闭环/sparc advance是阶段推进的唯一合法入口smoke.sh保证插件结构契约不漂移neural_predict/neural_train与patterns命名空间让跨特性的执行经验持续沉淀。掌握这份技能你就能在 ruflo 生态中把任何通过了 Specification 门禁的特性以先伪代码、再架构、后实现的节奏高质量落地且每一步都有可检索、可评审、可回归的工程证据。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
ruflo-sparc 实战：用 SPARC Phase 2/3 技能完成伪代码设计与架构契约落地
ruflo-sparc 实战用 SPARC Phase 2/3 技能完成伪代码设计与架构契约落地【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo本篇技术指南聚焦 ruflo-sparc 插件中的sparc-implement技能SKILL.md讲解如何按 SPARC 方法论执行 Pseudocode伪代码与 Architecture架构两个阶段并在门禁通过后进入实现。读完本文你将掌握如何基于 Specification 阶段的验收标准编写带复杂度标注的语言无关伪代码、如何用 DDD 边界上下文与 TypeScript 类型化 API 契约定义模块边界、如何把两份产物写入 AgentDB 命名空间并推进阶段状态以及如何用/sparc advance通过 Phase 3 门禁。一、技能定位SPARC 五阶段中的 Phase 2/3ruflo-sparc 是 ruflo 生态中的 SPARC 方法论编排插件见 README将特性开发拆分为五个带质量门禁的阶段每个阶段必须通过门禁检查才能进入下一阶段阶段名称门禁标准派生的 Agent1Specification≥ 3 条验收标准、约束、边界情况researcher2Pseudocode覆盖全部 AC、错误路径显式、复杂度已标注planner3Architecture约束全部被处理、类型化 API 契约、无循环依赖system-architect4Refinement全部 AC 有通过测试、评审通过、覆盖率 ≥ 80%codertester5Completion测试全绿、文档完整、部署清单已验证reviewersparc-implement技能同时覆盖 Phase 2 与 Phase 3因为二者紧密耦合算法设计伪代码会反过来约束模块边界模块边界也会修正算法方案。技能的 frontmatterallowed-tools明确授权了memory_store/memory_search/memory_retrieve、task_create/task_update/task_complete、hooks_intelligence_trajectory-step、neural_predict、workflow_create以及Bash / Read / Write / Edit文件能力——这意味着技能既负责设计也负责落地实现。二、使用前提Specification 阶段完成并通过门禁技能文档明确指出使用时机Specification 阶段完成后且其门禁已通过。在 ruflo 中这意味着在此之前已完成以下铺垫通过/sparc init feature初始化工作流创建 feature slug、在sparc-state写入current-phase-{slug}状态、在sparc-phases预置spec-{slug}占位详见 ruflo-sparc 命令文档通过/sparc-spec feature-description技能完成需求收集、至少 3 条 Given/When/Then 格式的验收标准AC、约束清单与边界情况清单并将产物以spec-{feature-slug}键存入sparc-phases命名空间见 sparc-spec/SKILL.md通过/sparc advance让 Phase 1 门禁判定通过校验 AC 数量、约束与边界情况是否齐备阶段推进到 2。从 sparc-orchestrator Agent 定义 可以确认门禁协议的固定流程检索sparc-phases中的阶段产物 → 逐条评估门禁标准任一不通过即整体失败→ 结果写入sparc-gates→ 失败则返回当前阶段并给出改进建议成功才推进阶段计数并通知用户。三、执行前的三条检索步骤让设计建立在前序证据之上sparc-implement的第 13 步不是直接写代码而是先检索证据确保设计可追溯检索规格调用mcp__plugin_ruflo-core_ruflo__memory_search命名空间sparc-phases查询该特性的 spec抽取需求、验收标准、约束与边界情况——伪代码必须逐条满足 AC这是 Phase 2 门禁的核心检索阶段状态调用memory_search命名空间sparc-state确认当前处于 Phase 2 或 Phase 3防止阶段漂移orchestrator 文档强调任何阶段操作前先取回当前状态检索历史模式调用mcp__plugin_ruflo-core_ruflo__neural_predict用特性描述预测过去项目中相关的架构决策。这是 ruflo 智能体自我学习闭环的一环——sparc-refine 技能 会在整轮 SPARC 结束时用neural_train回灌成功数据而patterns命名空间注意是复数与 ReasoningBank 的pattern保留命名空间不同存储跨特性的经验模式供后续neural_predict复用。四、Phase 2 伪代码设计先想清楚再动手Phase 2 的目标是在写生产代码之前完成算法与数据流设计。技能文档给出了 5 个子步骤全部必须落地为每条验收标准写语言无关伪代码不绑定具体编程语言保证可移植、可评审定义核心数据结构并带类型标注如{ field1: type, field2: type }绘制控制流必须覆盖三类路径Happy path正常路径每个边界情况的错误/异常路径如适用并发访问处理标注关键路径的算法复杂度时间与空间用于后续性能验证——sparc-refine 技能 的 Phase 4 会针对伪代码中标注的关键路径做 profiling比对规格中的性能约束阈值存储伪代码产物调用memory_store命名空间sparc-phases键pseudo-{feature-slug}值为 JSON 结构{ status: complete, algorithms: [...], dataStructures: [...], controlFlow: [...], complexity: {...} }Phase 2 门禁见 README 与 orchestrator 定义会校验伪代码是否覆盖规格中全部 AC、错误路径是否显式、复杂度是否已标注。五、Phase 3 架构设计DDD 边界、API 契约与模块规划Phase 3 在伪代码之上建立架构包含 5 个子步骤定义边界上下文与聚合根DDD 模式识别实体边界与值对象、定义聚合不变量aggregate invariants、映射领域事件。ruflo 中这一步与 ruflo-ddd 插件契约 直接对齐——该插件提供ddd-context/ddd-aggregate/ddd-validate三个技能把领域模型以分层节点 因果边的图结构存入 AgentDBddd-contexts命名空间orchestrator 在 Phase 3 会查询该命名空间复用已有领域模型设计 API 契约用 TypeScript 接口定义请求/响应 schema、错误响应码与格式如 400 校验失败 / 409 冲突 / 500 内部错误、适用时给出版本化策略规划模块边界目录结构、依赖方向规则禁止循环依赖——这是 Phase 3 门禁检查项之一、公开接口与内部接口的区分明确基础设施关注点持久化策略数据库/缓存/文件、消息模式同步/异步/事件驱动、配置与环境要求存储架构产物调用memory_store命名空间sparc-phases键arch-{feature-slug}值为{ status: complete, boundedContexts: [...], apiContracts: [...], moduleBoundaries: {...}, infrastructure: {...} }ruflo-sparc 的 ADR-0001 明确了 Phase 3 的能力归属架构阶段由ruflo-adr生成 ADR与ruflo-ddd边界上下文建模做深度支撑ruflo-sparc负责编排生命周期兄弟插件负责各阶段深水区工作。六、推进状态、记录轨迹并开始实现Phase 2/3 产物入库后技能要求连续执行三个动作更新阶段状态memory_store命名空间sparc-state将当前阶段更新为 3Architecture并记录两份产物键pseudo-{slug}、arch-{slug}记录轨迹步调用mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-step写入架构摘要——这与 sparc-spec 的trajectory-start、sparc-refine 的trajectory-end共同构成整轮 SPARC 的执行轨迹供后续智能体学习开始实现用户确认后按照既定模块边界创建文件先实现接口与类型再实现核心逻辑严格对应伪代码同时编写单元测试尽量 TDD最后运行测试验证 AC。实现阶段的产物规范在输出模板的 Module Structure 一节中有明确约定{feature}.types.ts接口与类型、{feature}.service.ts业务逻辑、{feature}.controller.tsHTTP 处理、{feature}.repository.ts数据访问、{feature}.test.ts测试。七、标准输出格式模板技能文档定义了完整的输出格式展示给用户的设计产物应遵循此结构# Pseudocode: {Feature Name} ## Core Algorithms ### Algorithm 1: {name} FUNCTION processRequest(input): VALIDATE input against schema IF invalid THEN THROW ValidationError result - TRANSFORM input STORE result RETURN result Complexity: O(n) time, O(1) space ## Data Structures - {StructName}: { field1: type, field2: type } --- # Architecture: {Feature Name} ## Bounded Contexts - {ContextName}: {description} - Aggregates: {list} - Events: {list} ## API Contracts ### POST /api/{resource} - Request: { field1: string, field2: number } - Response: { id: string, ...fields } - Errors: 400 (validation), 409 (conflict), 500 (internal) ## Module Structure src/{feature}/ {feature}.types.ts # Interfaces and types {feature}.service.ts # Business logic {feature}.controller.ts # HTTP handling {feature}.repository.ts # Data access {feature}.test.ts # Tests ## Infrastructure - Persistence: {strategy} - Caching: {strategy} - Events: {strategy} --- Phases 2-3 complete. Run /sparc advance to pass the gate check.八、门禁收口/sparc advance与可验证的契约设计产物呈现给用户后技能建议运行/sparc advance触发 Phase 3 门禁。根据 命令文档Phase 3 门禁会校验三条硬性标准架构是否处理了规格中的全部约束API 契约是否为类型化TypeScript 接口无循环依赖。门禁结果以gate-{phase}-{slug}-{timestamp}为键写入sparc-gates通过则sparc-state阶段递增并提示进入 Phase 4失败则gateAttempts递增并列出阻塞项与对应改进建议。除advance外命令还提供init、status含进度条[ ] Phase 3/5 — Architecture、phase phase-name支持spec/pseudo/arch/refine/complete别名与 1-5 数字向前跳跃会警告跳过门禁和report生成含追踪矩阵的完整方法论报告。这一整套契约并非无据可依插件根目录的 smoke.sh 以 11 项结构化检查作为契约即验证smoke-as-contract——包括 5 个阶段名齐备、3 个技能 1 个 Agent 1 个命令 frontmatter 有效、sparc-state/sparc-phases/sparc-gates三个命名空间被认领、phase-to-plugin 对齐表存在、ADR-0001 状态为 Accepted、以及技能allowed-tools无通配符越权。运行bash plugins/ruflo-sparc/scripts/smoke.sh期望输出 11 passed, 0 failed。整条链路确保设计有门禁、产物有存储、状态可追踪、契约可回归。九、关键要点回顾两阶段联动伪代码设计Phase 2与架构设计Phase 3强耦合sparc-implement技能一并执行产物分别以pseudo-{slug}与arch-{slug}键入库全程可追溯每个设计决策都锚定到 spec 的验收标准与约束通过sparc-state/sparc-phases/sparc-gates三个命名空间形成完整的阶段-产物-门禁证据链先接口后实现实现顺序固定为接口与类型 → 核心逻辑 → 测试与架构产物中的模块边界一一对应生态协作Phase 3 的 DDD 建模与 ADR 记录分别由 ruflo-ddd 与 ruflo-adr 承担深水区工作ADR-0001 将这种阶段到插件的对齐固化为契约验证闭环/sparc advance是阶段推进的唯一合法入口smoke.sh保证插件结构契约不漂移neural_predict/neural_train与patterns命名空间让跨特性的执行经验持续沉淀。掌握这份技能你就能在 ruflo 生态中把任何通过了 Specification 门禁的特性以先伪代码、再架构、后实现的节奏高质量落地且每一步都有可检索、可评审、可回归的工程证据。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
