dagu-workflow-builder
インストール済みのスキルが持つスクリプトを「型」でつなぎ、Dagu v2 の DAG を書き出す。
つなぎ方は scripts/chain.py が決定的に探す(LLM を呼ばない)。同じスキル・同じ入力なら、
どの環境でも同じ DAG ができる。
パス解決
この SKILL.md が置かれているディレクトリを SKILL_DIR とする。
CHAIN="python3 ${SKILL_DIR}/scripts/chain.py"
仕組み
- 各スキルは、スクリプトが受け取るもの・作るものを
chain.json(スキル直下)で宣言する。 書き方は references/contract.md。 chain.pyは各エージェントのスキル置き場(~/.copilot/skills・~/.claude/skills・~/.codex/skills・~/.kiro/skills・~/.agents/skills・~/.config/opencode/skillsの順)を見て宣言を集める。 同じ名前のスキルは先に見つかった方を使う。--skills-dirか環境変数DAGU_CHAIN_SKILLSで置き場を差し替えられる。- 手元の入力の型(
--from)から目的の型(--to)まで、ステップの延べ数が最小になる経路を選ぶ。 同じ数なら「スキル名/アクション名」の順で前のものを使う。 - 原則、エージェントを使わずに組む。 エージェント CLI にプロンプトを渡すアクション(
"agent")は、--allow-agentを付けたときだけ使う。付けても重く数えるので、スクリプトだけでつながるところはスクリプトが選ばれる。 CLI の起動方法はagents/<名前>.json(既定kiro)から組む。
手順
何が作れるかを見る
$CHAIN scan作りたい成果物の型が「作れる型」に無ければ、そこで止めて利用者に伝える(推測で DAG を書かない)。 スクリプトはあるのに
chain.jsonが無いスキルは、利用者の了承を得て宣言を足す(手順 5)。チェーンを確かめる
$CHAIN plan --from openapi=./openapi.yaml --to openapi-report- 入力のパスを省く(
--from openapi)と、実行時に渡す引数になる。 - 複数の目的は
--toを重ねる。独立したステップは Dagu が並列に流す。 - 選ばれた経路が意図と違うときは
--avoid <スキル>か--avoid <スキル>/<アクション>で外す。 - 組めないときは、足りない型と、それを作れるアクションの有無が出る。その内容を利用者に伝える。
- 「エージェント CLI を呼ぶアクション(…)を使えば組める」と出たら、そこで止めて利用者に伝える。
先にそのところをスクリプトで埋められないか(変換するスクリプトを持つスキルがないか)を確かめ、それでも無く、
利用者が了承したときだけ
--allow-agentを付けて作り直す。その DAG は実行のたびに LLM を使う。
- 入力のパスを省く(
DAG を書き出す
$CHAIN build --from openapi=./openapi.yaml --to openapi-report \ -o ~/.config/dagu/dags/openapi-check.yaml- エージェント CLI は
--agent-cli <名前>、モデルは--agent-model <モデル>で選ぶ(アクションがcliを指定していればそちらが勝つ)。 定義は$KIRO_AGENTS_DIR→./agents→~/.agents/agents→~/.kiro/agentsの順に探す。 - アクションのパラメータは
--param 名前=値(1 つのアクションに絞るなら--param スキル/アクション.名前=値)。 既定値の無いパラメータは、実行時に渡す引数になる。 - 定期実行にするなら、書き出した YAML の先頭に
schedule:を足す(生成物を直すのはそれだけにし、 つなぎ方を変えたいときは作り直す)。
- エージェント CLI は
実行して確かめる
dagu validate ~/.config/dagu/dags/openapi-check.yaml dagu start ~/.config/dagu/dags/openapi-check.yaml -- IN_OPENAPI=/abs/path/openapi.yaml成果物は実行ごとの作業フォルダ(
DAG_RUN_WORK_DIR)にできる。どのファイルがどの型かは YAML の先頭のコメントに書いてある。宣言を足す(必要なときだけ)
スキルのスクリプトを読み、references/contract.md の形で
chain.jsonを書いて検査する。 スクリプトが無く、エージェントに任せるしかない変換は"agent"のアクションで書く。スキルにしない 手元だけの宣言は別のファイルに書き、--actions <ファイル>で足す(scan/check/plan/buildのどれにも効く)。$CHAIN check <スキルのディレクトリ> $CHAIN --actions ./my-actions.json check型の名前は既存の宣言(
scanの「作れる型」)にあるものを優先して使う。同じものに別の名前を付けると チェーンがつながらない。
しないこと
- DAG のステップを手で書き足して、宣言に無いスクリプトをつながない(他の環境で同じ DAG が作れなくなる)。
- 宣言に無いエージェントのステップを DAG に手で足さない。エージェントに任せる変換も
"agent"のアクションとして宣言し、入出力の型を決める。