寫一條 workflow，這裡有你需要的全部語法 每種都有動畫 + sample JSON · 標明現行 / 逃生口走 run.py

{ "type":"agent", "name":"classify", "phase":"classify",
  "prompt":"判斷異常類型，輸出 JSON。",
  "outputs":{ "type":{"type":"str","enum":["latency","errors","other"]} } }

// 之後任何一步都能引用，validate_def 靜態檢查欄位存在
"on": "{steps.classify.type}"

骨子裡＝讀 .workflow/<id>/step_classify/main.json 的 result.fields.type（既有 journal 條目,不另立新檔）。

"outputs": {
  "type": { "type":"str", "enum":["latency","errors","other"] },
  "score": "float"
}
// 型別：str|int|float|bool|list|obj（地基）
// 進來的值：{config.x}、{inputs.y}（觸發時傳入）

{ "type":"map", "name":"tr", "over":"src/**/*.md",
  "as":"f", "phase":"translate",
  "do":[ {"type":"agent","phase":"translate",
          "prompt":"翻 {f}","out":"out/{f}.en.md"} ] }

{ "type":"map", "over":"docs/*.txt", "as":"d", "phase":"proc",
  "do":[
    {"type":"sandbox","phase":"proc","run":"python clean.py {d}"},
    {"type":"agent","phase":"proc","prompt":"摘要 {d}","out":"sum/{d}.md"},
    {"type":"capability","call":"upsert_context_card","phase":"proc",
     "collection":"kb","keys":["{d}"],"title":"{d}","body":"..."}
  ] }

✗ do 內不可放 map 或 gate（Q7，validate_def 擋）—— 這就是「不准巢狀遞迴」與「gate 只能在頂層」。

{ "type":"agent", "name":"extract", "phase":"extract",
  "prompt":"抽出所有待辦", "outputs":{"items":"list"} },

{ "type":"map", "over":"{steps.extract.items}", "as":"t", "phase":"card",
  "do":[ {"type":"capability","call":"upsert_context_card","phase":"card",
          "collection":"tasks","keys":["{t.id}"],
          "title":"{t.title}","body":"{t.body}"} ] }

{ "type":"map", "over":{"range":"{inputs.n}"},
  "as":"i", "phase":"gen",
  "do":[ {"type":"agent","phase":"gen",
          "prompt":"產生第 {i} 個變體","out":"v/{i}.md"} ] }

{ "type":"sandbox", "phase":"collect",
  "run":"python index.py --files {steps.tr.outputs}" }

另一種收法：也可以 glob "out/*" 收回，只是要自己記得檔落在哪；.outputs 讓引擎替你記住每個元素的身份。

// map 自帶 skip+collect：
// 失敗元素 → run.failures[]（key + error），不炸整批
// 前端顯示 "27/30 · 3 failed"

{ "type":"switch", "on":"{inputs.kind}", "phase":"route",
  "cases":{
    "md": [ {"type":"agent","phase":"route","prompt":"...","out":"o.md"} ],
    "csv":[ {"type":"sandbox","phase":"route","run":"python csv.py"} ]
  }, "default":[] }

{ "type":"sandbox", "name":"measure", "phase":"measure",
  "run":"python measure.py", "outputs":{"dropped":"bool"} },

{ "type":"switch", "on":"{steps.measure.dropped}", "phase":"route",
  "cases":{ "true":[ {"type":"gate","phase":"route","title":"要深入？"},
                     {"type":"agent","phase":"route","prompt":"分析原因","out":"rca.md"} ] },
  "default":[] }

{ "type":"agent", "name":"classify", "phase":"classify",
  "prompt":"判斷異常類型",
  "outputs":{"type":{"type":"str","enum":["latency","errors","other"]}} },

{ "type":"switch", "on":"{steps.classify.type}", "phase":"route",
  "cases":{ "latency":[...], "errors":[...], "other":[...] } }

{ "type":"agent", "name":"draft", "phase":"draft",
  "prompt":"擬週報。修改意見：{steps.review.feedback}",
  "out":"report.md" },

{ "type":"gate", "name":"review", "phase":"review", "title":"審週報",
  "summary_from":"report.md",
  "allow":["approve","revise","reject"],
  "revise_to":"draft" }
// approve→續　reject→整條結束　revise→帶 {steps.review.feedback} 回 draft
// 具名 gate「review」的 feedback = {steps.review.feedback}（唯一合法的向前引用）

三個選項：approve（過）、reject（結束、什麼都不留）、revise（附一句自由回饋、打回 revise_to 指名的那步重做）。回饋以 {steps.<gate>.feedback} 注入該步 prompt（跟其他具名產出同一種寫法,讓唯一的回邊在圖上顯式）—— 同 steer 的自由指令精神。

{ "type":"gate", "phase":"review", "title":"確認要發布？",
  "summary_from":"out/*.md", "allow":["approve","reject"] }

{ "type":"capability", "call":"ingest_to_collection",
  "phase":"ingest", "collection":"docs", "path":"out/*.md" }

{ "type":"agent", "phase":"draft", "prompt":"產生摘要",
  "out":"sum.md",
  "check":{"file_nonempty":{"path":"sum.md"}},
  "retries": 2 }

check 的參數也吃插值，例如 allowed 可來自 {config.kinds}。