workflow-builder について
workflow-builder は、繰り返し実行できる複数ステップの AI ワークフローを設計・実行するエージェントスキルです。ステップごとのモデル指定や、依存しないステップの並列実行に対応します。
主な機能
- 01ワークフローの計画と実行
- 02既存ワークフローの再開
- 03タグによるモデル割り当て
- 04独立したステップの並列実行
- 05ステップ間の出力受け渡し
活用シーン
- 01複数ステップの AI ワークフロー設計
- 02保存済みワークフローの実行や再開
- 03独立した調査ステップの並行実行
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ somnio-software/ somnio-ai-tools --skill workflow-builderインストール後、Claude Code で/workflow-builderを入力して読み込まれたか確認します。
同梱ファイルreferences/plan.mdreferences/run.md
詳細
ワークフロービルダー
カスタムの再利用可能な複数ステップの AI ワークフローを作成して実行します。各ステップで異なるモデルを使用でき、依存関係のないステップは並列ウェーブで実行されます。
機能
このスキルには 2 つのモードがあります。
| モード | 使用する場面 | リファレンス |
|---|---|---|
| Plan | 新しいワークフローを作成または設計したい場合 | references/plan.md |
| Run | ワークフローを実行、再開、または再実行したい場合 | references/run.md |
クイックスタート
- 作成:「dependency-cleanup というワークフローを作成して」
- 実行:「dependency-cleanup ワークフローを実行して」
- 再開:「dependency-cleanup ワークフローを再開して」
振り分け
メッセージまたは $ARGUMENTS からユーザーの意図を判断します。
-
ユーザーが「create」「plan」「design」「new workflow」と言った場合
→references/plan.mdを読み、その指示に従います -
ユーザーが「run」「execute」「start」「resume」と言った場合
→references/run.mdを読み、その指示に従います -
$ARGUMENTSがplanで始まる場合
→references/plan.mdを読み、残りの引数をワークフロー名として扱います -
$ARGUMENTSがrunで始まる場合
→references/run.mdを読み、残りの引数をワークフロー名として扱います -
意図が不明な場合は、ユーザーに尋ねます。
「新しいワークフローを作成しますか、それとも既存のワークフローを実行しますか?」
ワークフローの構造
ワークフローは .somnio/workflows/<name>/ にある、次の内容を含むディレクトリです。
.somnio/workflows/<name>/
├── context.md — Manifest with step list and metadata
├── 01-<step-name>.md — Step 1 prompt
├── 02-<step-name>.md — Step 2 prompt
├── ...
├── config.claudecode.json — Model assignments (optional)
├── progress.json — Execution state (auto-generated)
└── outputs/ — Step output files (auto-generated)
主な概念
- ステップは新しい AI コンテキスト(個別のサブエージェント)で実行されます
- タグ(
research、planning、execution)によってモデルの割り当てが決まります - 依存関係(
needs)によって並列ウェーブのグループ分けが決まります - プレースホルダー(
{output_path}、{step_N_output})によってステップ間でデータを受け渡せます needsのない依存関係のないステップは、同じウェーブ内で並列実行されます