ruflo Workflow Automation 实战指南多步骤流程的创建、编排与模板管理【免费下载链接】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/rufloruflo 作为多 Agent 元编排框架将复杂多步骤过程自动化沉淀为一套可复用的 Workflow Automation 能力。本文基于 .agents/skills/workflow-automation/SKILL.md 展开系统讲解如何用claude-flow命令创建、执行、导出与监控工作流并结合仓库源码剖析其底层两种编排表面MCP 生命周期工作流与原生 JS 编排脚本的实现差异与选型依据。读完本文你将掌握从零构建一个具备依赖关系、阶段式执行与可追溯状态的自动化流水线并把工作流固化为可复用模板的完整方法。一、这个技能解决什么问题Workflow Automation Skill 面向的是多步骤、需要编排与状态管理的自动化任务。它的定位非常明确触发时机多步骤自动化过程、可复用工作流创建、复杂任务编排、CI/CD 流水线搭建跳过场景简单单步任务、临时的一次性操作这类任务直接用 Agent 单次执行即可无需引入工作流引擎。换言之当一项工作不是一个 TodoList 线性推进能覆盖、而是有着真实依赖图、需要步骤间产出传递与跨会话可恢复时工作流才是正确的抽象。这一点在底层 MCP 工具的实现说明中写得更加直白在 workflow-tools.ts 中workflow_run/workflow_create的工具描述反复强调当工作存在需要持久化、重试策略、暂停/恢复与 LLM 驱动步骤间产出绑定的真实依赖图时使用单一线性待办列表用原生 TodoWrite 即可。二、核心命令详解Skill 文档定义了一套以npx claude-flow workflow为主体的命令面涵盖工作流全生命周期# 从模板创建工作流 npx claude-flow workflow create --name deploy-flow --template ci # 执行工作流可指定环境变量 npx claude-flow workflow execute --name deploy-flow --env production # 列出全部工作流 npx claude-flow workflow list # 将工作流导出为可复用模板/文件 npx claude-flow workflow export --name deploy-flow --format yaml # 查看工作流运行状态 npx claude-flow workflow status --name deploy-flow2.1 命令面在仓库中的实际落地需要注意命令的精确集合会随 CLI 版本演化。从当前仓库的 V3 CLI 实现 v3/claude-flow/cli/src/commands/workflow.ts 可见workflow主命令实际注册了以下子命令子命令用途关键参数workflow run执行工作流-t/--template、-f/--file、--task、-p/--parallel默认 true、-m/--max-agents默认 5、--timeout分钟默认 30、-d/--dry-runworkflow validate校验工作流定义-f/--file必填、-s/--strictworkflow list列出工作流-s/--statusrunning/completed/failed/all、-l/--limit默认 10workflow status查看单个工作流状态--watchworkflow stop停止运行中的工作流-f/--forceworkflow template模板管理list/show/create实际使用请以npx claude-flow workflow --help与claude-flow workflow subcommand --help输出的参数为准。以下是源码示例中给出的可直接复制的组合用法# 以 development 模板执行并携带任务描述 claude-flow workflow run -t development --task Build auth system # 从 YAML 定义文件执行校验 执行一次完成 claude-flow workflow run -f ./workflow.yaml # SPARC 模板做干跑验证不产生任何副作用 claude-flow workflow run -t sparc --dry-run # 先校验再执行校验结果含 stages/agents/预计耗时 claude-flow workflow validate -f ./workflow.yamlrun子命令交互式运行时未传-t/-f会弹出模板选择器--dry-run模式下流程只做校验status 变为validated不会在存储中落盘任何工作流记录适合上线前演练。2.2 底层 MCP 工具面命令面并非孤岛——每个子命令背后都调用一个同名 MCP 工具。以 ADR-0001ruflo-workflows plugin contract 为契约ruflo-workflows插件封装了10 个workflow_*MCP 工具实现在 workflow-tools.tsMCP 工具用途对应命令workflow_create创建持久化工作流定义workflow createworkflow_run以模板/文件运行工作流workflow runworkflow_execute执行一次性不持久化工作流workflow executeworkflow_status检查运行中工作流workflow statusworkflow_list列出工作流workflow listworkflow_pause/workflow_resume/workflow_cancel暂停 / 恢复 / 取消生命周期控制workflow_delete删除工作流定义清理workflow_template管理模板workflow template存储与状态机工作流定义与运行状态以 JSON 形式持久化在项目.claude-flow/workflows/store.json源码常量见 workflow-tools.ts。状态机为created → running ↔ paused → completed / cancelled其运行时索引归属workflows-stateAgentDB 命名空间——这就是跨会话可暂停/恢复能力的来源。三、内置模板清单Skill 文档声明了以下内置模板覆盖了软件交付侧最常见的流水线形态模板用途ci持续集成流水线deploy部署工作流test测试工作流release发布自动化review代码评审工作流3.1 V3 CLI 中的模板清单在 V3 CLI 中模板系统被建模为可枚举、可展示、可固化的对象。源码 workflow.ts 定义了如下可选项且每个模板都预置了阶段划分、参与 Agent 类型与预计耗时见同文件 L703-L740 的辅助函数模板 value阶段示例默认 Agents预计耗时developmentPlanning → Implementation → Testing → Review → Integrationcoder, tester, reviewer15-30 minresearchDiscovery → Analysis → Synthesis → Documentationresearcher, analyst10-20 mintestingUnit → Integration → E2E → Performancetester, coder5-15 minsecurity-auditThreat Model → Static → Dynamic → Reportsecurity-architect, security-auditor20-40 mincode-reviewInitial Review → Security Check → Quality → Feedbackreviewer, security-auditor, analyst10-25 minrefactoringAnalysis → Planning → Refactor → Validationarchitect, coder, reviewer15-35 minsparcSpecification → Pseudocode → Architecture → Refinement → Completionarchitect, coder, tester, reviewer25-45 mincustomInitialize → Execute → Completecoder10-20 min模板管理与路由workflow template list展示全部模板workflow template show name查看某模板的阶段与 Agent 构成workflow template create -n name [-w workflowId | -f file]可将一次运行固化为新模板之后即可用claude-flow workflow run -t name反复调用。仓库中预置的 Agent 角色定义可在 v3/agents如coder.yaml、reviewer.yaml、tester.yaml、security-architect.yaml找到对应能力配置。四、Workflow 结构与步骤建模工作流定义采用声明式 YAML其最小结构是阶段名 执行 Agent 依赖关系 任务描述name: example-workflow steps: - name: analyze agent: researcher task: Analyze requirements - name: implement agent: coder depends: [analyze] task: Implement solution - name: test agent: tester depends: [implement] task: Write and run tests4.1 底层步骤模型的类型化这套 YAML 在引擎内部会被解析为类型化的步骤对象。源码 workflow-tools.ts 定义了WorkflowStep与WorkflowRecord两个核心接口步骤类型typetask任务、condition条件分支、parallel并行扇出、loop循环、wait等待/门控步骤状态statuspending → running → completed / failed / skipped可回溯每步的开始与完成时间工作流状态record.statusdraft / ready / running / paused / completed / failed配合currentStep游标实现断点续跑variables承载模板名与运行期选项实现步骤产出向后续步骤的绑定传递。从这套数据结构可以推断引擎并不把工作流当作一串命令而是当作一组带依赖图、带生命周期、可暂停可恢复的步骤记录来管理——这与第一节所述的设计意图完全吻合。五、两种编排表面的选型MCP 生命周期 vs 原生 JS 编排ruflo 项目在 MCP 声明式工作流之外还支持 Claude Code 原生的Workflow工具编排脚本二者是互补而非替代关系契约由 ADR-0002native workflow orchestration 确立维度MCPworkflow_*原生WorkflowJS形态声明式定义 生命周期状态机命令式 JS 编排脚本工作单元持久化的工作流步骤子 Agentagent()持久化有状态、跨会话可恢复workflows-state每次运行的 journal经resumeFromRunId恢复并发引擎调度步骤parallel()屏障 /pipeline()流式适用场景长期存活、可暂停、有人工门控的流水线大规模扇出审查、审计、迁移、研究存放位置AgentDB 中的定义.claude/workflows/*.js选 MCP 表面需要长时间运行、步骤间需人工审批门控、要暂停后在断点继续的场景走 MCP 定义 workflow_run生命周期驱动选原生表面需要把一项大任务确定性扇出给多个子 Agent、并在代码中聚合结构化结果的场景编写.claude/workflows/*.jsworkflow-create 提供完整创作指引workflow-run 提供运行与恢复指引。两者的差异在parallel()屏障式等待全部完成后再聚合与pipeline()流式各条目独立流经各阶段之间体现得最为典型ADR-0002 明确建议优先使用pipeline而非parallel屏障因为前者的吞吐与隔离性更优。六、Best Practices把工作流做成可靠资产Skill 文档给出了四条核心实践结合仓库实现可进一步细化明确定义步骤依赖关系在depends中显式声明前置步骤让引擎据此构建依赖图真实依赖图正是该用工作流而非线性 TodoList的判据。按步骤选择合适 Agent 类型将 Agent 角色与任务性质对齐分析交给researcher、实现交给coder、质量把关交给tester/reviewer、安全交给security-auditor。源码中每个模板的getTemplateAgents都是这种对齐的预置样例。纳入验证门控validation gates正式执行前先workflow validate -f ./workflow.yaml必要时加--strict或对高频流水线以--dry-run演练校验结果会逐行报告错误行号 严重级别与告警杜绝带病上线。导出工作流以便复用通过模板固化workflow template create或export为 YAML 保存为仓库资产让 CI/CD、发布、评审等流程一次建设、处处复用并纳入版本管理。此外还建议为workflow run设置合理的--timeout上限防止失控用workflow status workflowId观察progress、token 消耗与 spawn 的 Agent 数对不再使用的定义用workflow_delete及时清理避免store.json膨胀。七、延伸阅读工作流自动化技能定义本文主体V3 CLI workflow 命令实现子命令与模板路由源码10 个 workflow MCP 工具实现持久化存储与步骤模型ADR-0001workflows 插件契约ADR-0002原生 Workflow 编排ruflo-workflows 命令手册workflow-create / workflow-run 技能【免费下载链接】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），仅供参考