workflow-run について
workflow-runは、保存済みのMCPワークフローや名前付きのネイティブJavaScriptワークフローを実行・管理するスキルです。実行、監視、一時停止、再開、キャンセル、スクリプトへの引数渡しに対応します。
主な機能
- 01保存済みMCPワークフローの実行
- 02状態と各ステップの結果を監視
- 03MCP実行の一時停止・再開・キャンセル
- 04名前付きJavaScriptワークフローの実行
- 05引数の指定または実行IDからの再開
活用シーン
- 01人の承認が必要なワークフローの管理
- 02一時停止したMCPワークフローの再開
- 03名前付きサブエージェント展開ワークフローの実行
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
決定論的なサブエージェントのファンアウトが必要な場合は、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でリアルタイムの進捗を確認できます。 - ここでの一時停止/再開は、MCP のステートマシンではなく、ジャーナルベース(
resumeFromRunId)です。再開するには、まず実行を停止し、その後runIdを指定します。 - 新しいネイティブワークフローを作成するには、
workflow-createスキルを使用します。
ADR-0002 を参照してください。
コメント
Markdown 対応