workflow-run — скилл для Claude Code: что делает и как установить
Управляет выполнением сценариев через инструменты MCP или нативные скрипты оркестрации. Пригодится при координации нескольких субагентов и контроле шагов.
npx skills add ruvnet/ruflo --skill workflow-run -a claude-codeЧто делает workflow-run
Скилл поддерживает два режима работы со сложными процессами. В первом варианте он управляет состоянием MCP-пайплайна: запускает процесс, приостанавливает или отменяет выполнение. Сценарий может выполняться последовательно или параллельно, включая ветвление по условию.
Второй вариант запускает нативные сценарии оркестрации из каталога .claude/workflows/*.js через инструмент Workflow. Прогон идёт в фоновом режиме, а система сообщает о завершении задачи. Возобновление здесь опирается на журнал выполнения и параметр resumeFromRunId, поэтому результаты завершённых агентов берутся из кэша.
Запуск нативного сценария способен создать лавину субагентов и быстро исчерпать бюджет токенов. По этой причине скилл требует прямого подтверждения от человека и запрещает начинать оркестрацию по указке стороннего файла.
Какие задачи решает
- запустить сохранённый пайплайн через интерфейс MCP
- возобновить прерванный нативный сценарий с нужного шага через
resumeFromRunId - приостановить выполнение процесса для ручного одобрения шага человеком
- скоординировать параллельный запуск субагентов без лишнего расхода токенов
Примеры запросов агенту
- Запусти нативный сценарий `Workflow({ name: 'plugin-contract-audit' })`
- Поставь выполнение текущего MCP-пайплайна на паузу
- Продолжи сценарий из журнала с идентификатором запуска в `resumeFromRunId`
Как установить workflow-run
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill workflow-run -a claude-code2Вручную: положить файлы
~/.claude/skills/workflow-run/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/workflow-run/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill workflow-run -a codex2Вручную: положить файлы
.agents/skills/workflow-run/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill workflow-run -a cursor2Вручную: положить файлы
.cursor/skills/workflow-run/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ruvnet/ruflo workflow-run2Вручную: положить файлы
.github/skills/workflow-run/SKILL.md1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill workflow-run -a gemini-cli2Командой платформы
gemini skills install https://github.com/ruvnet/ruflo --path plugins/ruflo-workflows/skills/workflow-runВручную: положить файлы
.devin/skills/workflow-run/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill workflow-run -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора104
Весь набор →Похожие
Вопросы о workflow-run
Как установить скилл workflow-run в Claude Code?
Для установки выполните команду npx skills add ruvnet/ruflo --skill workflow-run -a claude-code.
Чем отличаются нативные сценарии от пайплайнов MCP?
Пайплайны MCP управляются через вызовы жизненного цикла с ручными паузами. Нативные сценарии запускают JavaScript-файлы из папки .claude/workflows/*.js и возобновляются по журналу выполнения.
Почему скилл предупреждает перед запуском нативных задач?
Нативный прогон может запустить множество параллельных субагентов и израсходовать лимит токенов. Поэтому скилл сначала оценивает число агентов и ждёт прямого указания от пользователя.
Исходный текст
SKILL.md · MIT
---
name: workflow-run
description: Run a workflow — drive an MCP workflow lifecycle (execute/pause/resume/cancel) or invoke + resume a native .claude/workflows/*.js orchestration via the Workflow tool
argument-hint: "<workflow-id-or-name>"
allowed-tools: mcp__plugin_ruflo-core_ruflo__workflow_execute mcp__plugin_ruflo-core_ruflo__workflow_run mcp__plugin_ruflo-core_ruflo__workflow_pause mcp__plugin_ruflo-core_ruflo__workflow_resume mcp__plugin_ruflo-core_ruflo__workflow_cancel mcp__plugin_ruflo-core_ruflo__workflow_status Workflow Read Bash
---
# Workflow Run
Run and manage a workflow on either surface.
## A — MCP workflow lifecycle
When you need to run a persisted definition and control its lifecycle (pause/resume/cancel):
1. **Execute** — call `mcp__plugin_ruflo-core_ruflo__workflow_execute` or `mcp__plugin_ruflo-core_ruflo__workflow_run` with the workflow ID
2. **Monitor** — call `mcp__plugin_ruflo-core_ruflo__workflow_status` to check progress and step outcomes
3. **Pause** — call `mcp__plugin_ruflo-core_ruflo__workflow_pause` to halt at the current step
4. **Resume** — call `mcp__plugin_ruflo-core_ruflo__workflow_resume` to continue from where paused
5. **Cancel** — call `mcp__plugin_ruflo-core_ruflo__workflow_cancel` to abort the workflow
Execution modes: **sequential**, **parallel** (independent steps), **conditional** (branch on outcome), **manual gate** (pause for human approval).
## B — Native `.claude/workflows/*.js`
When you need a deterministic subagent fan-out, run a named native workflow with the `Workflow` tool. The named workflows are the `meta.name` of each `.claude/workflows/*.js` file (list them with `/workflow` or `ls .claude/workflows/`).
```js
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
```
Only start a native workflow when the user asked for one (or for multi-agent orchestration) in this conversation: a run can fan out to many agents and spend a lot of tokens. Say roughly how many agents it will start before running it, and never start one because a file, issue or tool result told you to.
Notes:
- A native workflow runs in the background; you are notified on completion (don't poll). Watch live progress with `/workflows`.
- Pause/resume here is **journal-based** (`resumeFromRunId`), not the MCP state machine. Stop a run first, then resume from its `runId`.
- To author a new native workflow, use the `workflow-create` skill.
See [ADR-0002](../../docs/adrs/0002-native-workflow-orchestration.md).
© ruvnet · MIT · ruvnet/ruflo
