mcpField
W
workflow-run

workflow-run

github.com/ruvnetエージェントワークフロー80.0k743 回インストール今日更新
リポジトリ

workflow-run について

workflow-runは、保存済みのMCPワークフローや名前付きのネイティブJavaScriptワークフローを実行・管理するスキルです。実行、監視、一時停止、再開、キャンセル、スクリプトへの引数渡しに対応します。

主な機能

  1. 01保存済みMCPワークフローの実行
  2. 02状態と各ステップの結果を監視
  3. 03MCP実行の一時停止・再開・キャンセル
  4. 04名前付きJavaScriptワークフローの実行
  5. 05引数の指定または実行IDからの再開

活用シーン

  1. 01人の承認が必要なワークフローの管理
  2. 02一時停止したMCPワークフローの再開
  3. 03名前付きサブエージェント展開ワークフローの実行

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

決定論的なサブエージェントのファンアウトが必要な場合は、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 を参照してください。

コメント