Skip to main content

​
概要

npx @refrainai/cli compose -- \
  --branch-on <varName> \
  --case "match:path.yaml" \
  --output <path> \
  [options]
複数の生成済み手順書を、変数の値に基づく条件分岐を持つ1つの手順書にマージします。同じワークフローで入力に応じて異なるパスがある場合に有用です。

​
必須引数

引数説明
--output <path>合成した手順書 YAML の出力パス

​
オプション引数

引数デフォルト説明
--branch-on <varName>-分岐条件の変数名（省略時は対話的に入力）
--case "match:path.yaml"-ケース定義 — 複数指定可
--goal <text>-合成した手順書のゴール説明
--locale <code>enUI 言語: en または ja
--branch-on や --case を省略すると、CLI が対話モードに入り入力を求めます。

​
動作の仕組み

1

入力の収集

分岐変数、ケース、ゴールを収集（CLI 引数または対話的に）。
2

手順書の読み込み

各ケースの YAML ファイルを読み込みバリデーション。
3

変数のマージ

全ケースの変数をマージ。分岐変数を source: prompt で追加。
4

分岐の構築

全ケースのステップを1つの branches ステップに組み立て。
5

プレビューと編集

合成した手順書をプレビューし、保存前に調整が可能。
6

出力の書き込み

最終 YAML を Zod でバリデーションし、出力パスに書き込み。

​
使用例

​
CLI 引数で合成

npx @refrainai/cli compose -- \
  --branch-on accountType \
  --case "personal:./flows/personal-signup.yaml" \
  --case "business:./flows/business-signup.yaml" \
  --goal "アカウントタイプに基づいてサインアップを完了" \
  --output ./flows/signup-combined.yaml
これにより以下のような手順書が作成されます：
  1. ユーザーに accountType を入力させる
  2. "personal" の場合 → 個人サインアップのステップを実行
  3. "business" の場合 → 法人サインアップのステップを実行

​
対話モード

npx @refrainai/cli compose -- \
  --output ./flows/combined.yaml
CLI が分岐変数、ケース、ゴールを対話的に質問します。

​
出力構造

合成された手順書は branches を持つ1つのステップを含みます： 
title: アカウントタイプに基づいてサインアップを完了
variables:
  accountType:
    source: prompt
    description: "分岐変数"
    required: true
  # ... 全ケースからマージされた変数
steps:
  - ordinal: 0
    description: "accountType で分岐"
    branches:
      value: "{{accountType}}"
      cases:
        - match: "personal"
          steps:
            # ... personal-signup.yaml のステップ
        - match: "business"
          steps:
            # ... business-signup.yaml のステップ
分岐スキーマの詳細はループ・分岐を参照してください。