ruflo / Claude-Flow 的 SPARC 方法论命令从五阶段编排到多智能体交付全解【免费下载链接】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/rufloSPARCSpecification、Pseudocode、Architecture、Refinement、Completion是本仓库 rufloClaude-Flow内置的一套可执行的软件交付方法论它以命令文件.claude/commands/sparc.md为入口把大型目标拆解为可委派的子任务并以 17 个专业模式architect、code、tdd、debug、security-review、docs-writer、integration 等完成从规格澄清、伪代码设计、架构规划到 TDD 实施、集成与部署监控的完整闭环。读完本文你将掌握如何在 Claude Code / Codex / CLI 三种环境下调用sparc理解五种触发方式MCP、npx、本地安装、Swarm、非交互模式的参数语义并能在.claude/目录中定位每一阶段的模式定义与记忆/编排配置直接复用到自己的开发流程中。SPARC 命令在仓库中的定位与身份.claude/commands/sparc.md是一条注册在.claude/commands下的斜杠命令文件其 frontmatter 声明了--- name: sparc description: Execute SPARC methodology workflows with Claude-Flow ---从仓库结构看SPARC 并非孤立的单文件而是一套完整的方法论生态至少包含四层配套资源命令定义层sparc.md本体负责对外暴露调度语义每个专业模式的详细行为位于 .claude/commands/sparc 目录含architect.md、code.md、tdd.md、debug.md、security-review.md、docs-writer.md、integration.md、orchestrator.md、swarm-coordinator.md、spec-pseudocode.md、mcp.md、tutorial.md、supabase-admin.md等;方法论技能层.claude/skills/sparc-methodology/SKILL.md 完整定义了五阶段框架、模式清单、MCP 调用协议、编排模式与最佳实践是命令文档的教学底座;阶段 Agent 层.claude/agents/sparc 下按阶段沉淀了specification.md、pseudocode.md、refinement.md、architecture.md等专业角色;模板层.claude/agents/templates 提供了sparc-coordinator.md、implementer-sparc-coder.md等可复用的编排与执行模板。命令本体对执行者即 Agent 会话中的模型作出角色设定You are SPARC, the orchestrator of complex workflows.——把大的目标拆解为符合 SPARC 方法论的委派子任务并通过相应的专业模式specialist modes保证交付是安全secure、模块化modular、可测试testable、可维护maintainable的。SPARC 工作流五个被严格执行的阶段命令要求遵循如下五阶段流程每一阶段都有明确的禁止项或产出约束阶段动作要点硬性约束1. Specification规格澄清目标与范围绝不允许硬编码环境变量Never allow hard-coded env vars2. Pseudocode伪代码产出高层级逻辑必须携带 TDD 锚点TDD anchors3. Architecture架构保证系统图可扩展、服务边界清晰提供 extensible system diagrams 与 service boundaries4. Refinement精化依次使用 TDD、调试、安全、优化流程Red-Green-Refactor 纪律5. Completion完成集成、文档化、监控并持续改进交付后进入监控与持续改进循环在委派层面命令明确要求用new_task将第一阶段任务分派给专门的角色spec-pseudocode即规格与伪代码先行之后才进入架构与实施。仓库 .claude/commands/sparc/spec-pseudocode.md 即对应此角色的工作定义。这一先想清楚再动手的顺序是 SPARC 与单纯直接写码式提示词的本质区别。可用的 SPARC 专业模式清单命令文档宣告了如下 SPARC 模式以 Claude Code 斜杠命令形式注册对应仓库 .claude/commands/sparc 目录下的同名定义文件斜杠命令角色面向阶段/sparc-architect架构师Architecture/sparc-code自动编码器Refinement/sparc-tddTDD 测试员Refinement测试先行/sparc-debug调试器Refinement缺陷修复/sparc-security-review安全评审员Refinement / Completion/sparc-docs-writer文档写作者Completion/sparc-integration系统集成者Completion/sparc-post-deployment-monitoring-mode部署监控员Completion上线后监控/sparc-refinement-optimization-mode优化器Refinement性能/质量打磨/sparc-ask提问助手任意阶段答疑/sparc-devopsDevOpsCompletion发布自动化/sparc-tutorial教程学习引导/sparc-supabase-adminSupabase 管理数据/后端运维/sparc-spec-pseudocode规格写作者Specification / Pseudocode/sparc-mcpMCP 集成全阶段工具扩展/sparc-sparcSPARC 编排器全局调度在仓库中这些模式的可执行语义分散在 .claude/commands/sparc如architect.md、tdd.md、debug.md、security-review.md、docs-writer.md、integration.md、devops.md、spec-pseudocode.md、mcp.md、orchestrator.md并在 .claude/skills/sparc-methodology/SKILL.md 中按编排类 / 开发类 / 分析研究类 / 创意支持类四组进一步细分。SKILL 文档将其统称为 17 个专业化模式其中 orchestrator、swarm-coordinator、workflow-manager、batch-executor 负责协调与并行coder、architect、reviewer、tdd 负责开发researcher、analyzer、optimizer 负责研究分析designer、innovator、documenter、debugger、tester、memory-manager 提供设计与支持能力。快速启动三种调用入口方式一MCP 工具Claude Code 中推荐MCP 工具前缀mcp__claude-flow__sparc_mode可以直接在会话内触发无需离开编辑器。无 mode 参数时默认执行 SPARC 编排器传入mode则进入指定专业模式options用于携带模式专属参数// 运行 SPARC 编排器默认 mcp__claude-flow__sparc_mode { mode: sparc, task_description: build complete authentication system } // 运行指定模式 mcp__claude-flow__sparc_mode { mode: architect, task_description: design API structure } // TDD 工作流通过 options.workflow 声明执行完整流程 mcp__claude-flow__sparc_mode { mode: tdd, task_description: implement user authentication, options: {workflow: full} }字段语义说明task_description是必填的任务描述直接决定子任务拆解方向mode取值对齐上文模式清单如architect、tdd、coder、orchestratoroptions为可选的模式级控制面——例如{workflow: full}表示走完 TDD 全流程而非单次测试编写。方式二NPX CLIMCP 不可用时的回退# 运行 SPARC 编排器默认 npx claude-flow sparc build complete authentication system # 运行指定模式 npx claude-flow sparc run architect design API structure npx claude-flow sparc run tdd implement user service # 执行完整 TDD 工作流 npx claude-flow sparc tdd implement user authentication # 列出所有模式及其细节 npx claude-flow sparc modes --verbose # Alpha 特性通道 npx claude-flowalpha sparc run mode your task注意三种子命令形态的差异sparc task是整编走编排器默认流程sparc run mode task单点进入某个模式sparc tdd task是命名的 TDD 复合工作流。sparc modes --verbose用于在不确定可用模式时先做枚举。方式三本地安装若项目已本地初始化 claude-flow仓库根目录由./claude-flow指向安装产物可省略 npx 的网络拉取开销./claude-flow sparc build complete authentication system ./claude-flow sparc run architect design API structure在仓库内这一 CLI 体系对应 v3/claude-flow/cli/src/commands 下的命令实现SPARC 属于其中的开发方法论命令组初始化阶段执行npx -y claude-flowlatest init --sparc见 claude-flow-help.md即可把含.claude/命令与代理在内的工作区骨架一次性落地。方法论五阶段拆解与阶段 → 模式映射命令文档将 SPARC 展开为五个带图标标识的阶段与工作流节一一呼应但补充了每阶段的产出性质Specification规格定义需求、约束与验收标准Pseudocode伪代码创建详细的逻辑流与算法规划Architecture架构设计系统结构、API 与组件边界Refinement精化以 TDD 的 Red-Green-Refactor 循环实施Completion完成集成、文档化并按需求验收。每阶段应由哪些模式承担.claude/skills/sparc-methodology/SKILL.md 给出了明确映射阶段负责模式产出物Specificationresearcher、analyzer、memory-manager需求分析、用户故事、约束清单、成功指标Architecturearchitect、designer、orchestrator架构图、组件接口、数据库/API 契约、基础设施规划Refinementtdd、coder、tester失败测试 → 最小实现 → 重构循环Reviewreviewer、optimizer、debugger质量、安全、性能、文档评审Completionworkflow-manager、documenter、memory-manager集成、部署、监控、知识沉淀这与.claude/agents/sparc目录把 specification / pseudocode / architecture / refinement 沉淀为独立 agent 定义的仓库形态一致每一阶段背后都有专门的模型角色上下文而非由一个模型通吃所有职责。记忆集成规格与架构决策的跨会话持久化SPARC 强调把阶段产出写入持久化记忆使多个模式、多次会话共享同一份上下文避免重复澄清。使用 MCP 工具推荐// 存储规格 mcp__claude-flow__memory_usage { action: store, key: spec_auth, value: OAuth2 JWT requirements, namespace: spec } // 存储架构决策 mcp__claude-flow__memory_usage { action: store, key: arch_decisions, value: Microservices with API Gateway, namespace: architecture }字段语义action支持store等记忆操作key是条目主键value是需要长期保留的语义内容namespace是分区命名空间如spec、architecture用于把规格类与架构决策类记忆隔离便于定向检索。SKILL 文档中该工具还可携带ttl如86400000毫秒 24 小时过期与retrieve动作实现带生命周期的写入与跨 agent 取回。使用 NPX / 本地 CLI回退# 存储规格 npx claude-flow memory store spec_auth OAuth2 JWT requirements --namespace spec # 存储架构决策 ./claude-flow memory store arch_api RESTful microservices design --namespace arch # 查询既有工作内容--limit 控制返回条数 ./claude-flow memory query authentication --limit 10 # 导出项目记忆为可迁移的备份文件 ./claude-flow memory export sparc-project-backup.json配套的记忆类命令在仓库 .claude/commands/memory 中另有memory-usage.md、memory-search.md、memory-persist.md等细化定义export到 JSON 再配合 import 可在不同工作区之间迁移 SPARC 项目上下文。高级群体智能Swarm Mode 编排复杂任务当任务复杂度超出单模式承载能力例如需要多个 agent 长时间无超时协作命令文档提供 Swarm 编排入口其策略族在仓库 .claude/commands/swarm 有独立命令定义# 带监控的开发群并行多个开发 agent完成后自动评审 ./claude-flow swarm Build e-commerce platform --strategy development --monitor --review # 后台优化的群长任务不阻塞主会话 ./claude-flow swarm Optimize system performance --strategy optimization --background # 分布式研究群多机/多会话并行检索配合交互式 UI 可视化 ./claude-flow swarm Analyze market trends --strategy research --distributed --ui各 flag 的作用--strategy选定群的编排策略development / optimization / research 等对应 .claude/commands/swarm/development.md 一类的策略文档--monitor让主会话实时跟踪群成员进度--review在群交付后追加评审--background将任务置于后台进程--distributed启用分布式协调--ui启动交互式进程管理界面。与 claude-flow-help.md 的建议一致超过约 30 分钟的长任务优先使用 background 模式。非交互模式把 SPARC 接入 CI/CD面向流水线自动化的关键形态是--non-interactive配合权限显式开启可让 SPARC 在无人工应答的环境CI 作业、定时任务中执行./claude-flow sparc run code implement API --non-interactive ./claude-flow sparc tdd user tests --non-interactive --enable-permissions语义说明--non-interactive关闭一切需要人工确认的交互提示SPARC 基于规格自行推进--enable-permissions在非交互下显式授予执行操作所需权限否则安全策略可能默认拒绝因此该组合应仅在可信的受控环境中使用与命令中绝不硬编码敏感环境变量的安全底线保持一致。最佳实践清单命令文档收尾给出六条可执行的质量纪律模块化设计Modular Design保持单文件低于 500 行便于评审与维护;环境安全Environment Safety绝不硬编码密钥或环境变量值密钥一律走外部注入;测试先行Test-First任何实现之前必须先写测试;记忆使用Memory Usage重要决策与上下文即时入库供后续模式取用;任务收口Task Completion所有任务必须以attempt_completion结尾让编排器拿到明确的完成信号;查阅帮助所有可用命令见 claude-flow-help.mdSPARC 细节可进一步翻阅 sparc-modes.md 与 orchestrator.md。仓库级纵深SPARC 在 ruflo 中的落地路径速查若想基于本仓库深度定制或研究 SPARC可按下述索引继续阅读均为仓库根目录相对路径入口命令.claude/commands/sparc.md——本文所述的调度语义与三入口调用方式;方法论全集.claude/skills/sparc-methodology/SKILL.md——五阶段详细展开、17 模式能力说明、MCP 激活协议、五种编排模式Hierarchical / Mesh / Sequential Pipeline / Parallel / Adaptive以及 Red-Green-Refactor 的 MCP 级示例;模式命令定义.claude/commands/sparc 目录——architect.md、code.md、tdd.md、debug.md、security-review.md、docs-writer.md、integration.md、post-deployment-monitoring-mode.md、refinement-optimization-mode.md、devops.md、supabase-admin.md、spec-pseudocode.md、mcp.md、orchestrator.md、swarm-coordinator.md等;阶段 Agent 定义.claude/agents/sparc——specification / pseudocode / architecture / refinement 四个阶段角色;可复用模板.claude/agents/templates/sparc-coordinator.md 与 .claude/agents/templates/implementer-sparc-coder.md——SPARC 编排者与实施型 coder的提示词底模;配套命令族.claude/commands/memory记忆持久化、.claude/commands/swarm群体策略、.claude/commands/monitoring进度与指标监控。适用前提说明以上命令假设环境中已具备 claude-flow 运行时MCP 服务器提供mcp__claude-flow__sparc_mode等工具或可通过npx claude-flow/ 本地./claude-flow调用纯查看本文档而不安装任何运行时的用户可将其视为方法论规范与命令速查手册使用。【免费下载链接】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），仅供参考