关于 workflow-run
workflow-run 是用于运行和管理已保存 MCP 工作流或命名 JavaScript 原生工作流的技能,涵盖执行、监控、暂停、恢复、取消及向脚本传参。
主要功能
- 01运行已保存的 MCP 工作流
- 02监控状态和步骤结果
- 03暂停、恢复或取消 MCP 运行
- 04运行命名 JavaScript 工作流
- 05传递参数或按运行 ID 恢复
适用场景
- 01管理需要人工审批的工作流
- 02恢复已暂停的 MCP 工作流
- 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 工作流生命周期
需要运行已保存的定义并控制其生命周期(暂停/恢复/取消)时:
- 执行 — 使用工作流 ID 调用
mcp__plugin_ruflo-core_ruflo__workflow_execute或mcp__plugin_ruflo-core_ruflo__workflow_run - 监控 — 调用
mcp__plugin_ruflo-core_ruflo__workflow_status,查看进度和步骤结果 - 暂停 — 调用
mcp__plugin_ruflo-core_ruflo__workflow_pause,在当前步骤暂停 - 恢复 — 调用
mcp__plugin_ruflo-core_ruflo__workflow_resume,从暂停处继续 - 取消 — 调用
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