mcpField
W
workflow-run

workflow-run

github.com/ruvnetAgent 工作流80.0k743 次安装今天更新
代码仓库

关于 workflow-run

workflow-run 是用于运行和管理已保存 MCP 工作流或命名 JavaScript 原生工作流的技能,涵盖执行、监控、暂停、恢复、取消及向脚本传参。

主要功能

  1. 01运行已保存的 MCP 工作流
  2. 02监控状态和步骤结果
  3. 03暂停、恢复或取消 MCP 运行
  4. 04运行命名 JavaScript 工作流
  5. 05传递参数或按运行 ID 恢复

适用场景

  1. 01管理需要人工审批的工作流
  2. 02恢复已暂停的 MCP 工作流
  3. 03运行命名的子 Agent 扇出工作流

MCP 相关

对于已保存的工作流,该技能使用 MCP 工具执行、监控、暂停、恢复和取消运行;也介绍使用 `Workflow` 工具运行原生 `.claude/workflows/*.js` 工作流。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ruvnet/ruflo --skill workflow-run

安装后在 Claude Code 中输入/workflow-run确认已加载。

详细介绍

工作流运行

在任一界面上运行和管理工作流。

A — MCP 工作流生命周期

需要运行已保存的定义并控制其生命周期(暂停/恢复/取消)时:

  1. 执行 — 使用工作流 ID 调用 mcp__plugin_ruflo-core_ruflo__workflow_execute 或 mcp__plugin_ruflo-core_ruflo__workflow_run
  2. 监控 — 调用 mcp__plugin_ruflo-core_ruflo__workflow_status,查看进度和步骤结果
  3. 暂停 — 调用 mcp__plugin_ruflo-core_ruflo__workflow_pause,在当前步骤暂停
  4. 恢复 — 调用 mcp__plugin_ruflo-core_ruflo__workflow_resume,从暂停处继续
  5. 取消 — 调用 mcp__plugin_ruflo-core_ruflo__workflow_cancel,中止工作流

执行模式:顺序、并行(独立步骤)、条件(根据结果分支)、手动审批(暂停以等待人工批准)。

B — 原生 .claude/workflows/*.js

需要确定性地分派多个子 Agent 时,使用 Workflow 工具运行一个命名的原生工作流。命名工作流对应每个 .claude/workflows/*.js 文件中的 meta.name(使用 /workflow 或 ls .claude/workflows/ 列出)。

Workflow({ name: 'plugin-contract-audit' })                    // run a named workflow
Workflow({ name: 'plugin-contract-audit', args: 'ruflo-agentdb' })  // pass args → the script's `args` global
Workflow({ scriptPath: '.claude/workflows/foo.js' })           // run a script by path
Workflow({ scriptPath, resumeFromRunId: 'wf_…' })              // resume — unchanged agent() calls return cached

注意:

  • 原生工作流会在后台运行;完成后会通知你(不要轮询)。使用 /workflows 查看实时进度。
  • 此处的暂停/恢复基于日志记录(resumeFromRunId),而非 MCP 状态机。先停止运行,再从其 runId 恢复。
  • 若要编写新的原生工作流,请使用 workflow-create 技能。

参见 ADR-0002。

评论

支持 Markdown