s16: Workflow Runtime — 把编排写进代码

English · 中文 · 日本語

s15 → s16 → s17

计划别只活在嘴上。 脚本管先后，模型管每一步判断。

Harness 层: 编排 — 在单 agent 循环之上，再跑一套多 agent 脚本。

问题

你已经会让模型在一个循环里读文件、改代码、看报错。可有些活你其实早就知道先后顺序：先分维度审，再找人挑刺，最后汇总。若顺序只靠聊天记住，模型会做到一半喊完工，自己批改自己偏甜，压几轮上下文后连「别动 X」都丢了。

软对话扛不住并行、稳定结果形状，也扛不住崩了接着跑。你需要的不是更会聊天的模型，是一份写下来的编排。

解决方案

  你的对话 ──► Workflow(...) ──► 一条结果回来
                    │
                    ▼
            脚本：agent / pipeline / parallel
                    │
                    ▼
              变量 + journal（半成品放这儿，不塞群聊）

帮手（子 agent）仍负责想；脚本管循环、分发、合并。中间结果进变量和 journal，不进主对话。

一句话：编排从「智力」挪到「结构」。

左：通吃的固定流水线。右：为这次任务现裁的编排。

Claude Code 里有两扇门：动态——模型为这次任务写 JS（script / scriptPath）；已保存——好脚本用 name + args 再跑。门外还有用 SDK 事先写死的静态编排。本章是 Python 教学 runtime（不嵌 JS）：思想对齐，演示走「已保存」门。模型在产品里本来就能交脚本——我们只是不在这里跑 JS。

工作原理

1. 三个动词

  agent      一个帮手，一件事（可带 schema，拿到能往下传的 JSON）
  pipeline   每个 item 自己走完各阶段（默认，不等齐）
  parallel   等所有结果齐了再往下（屏障，少用）

谁失手：parallel 那个槽变成 null；pipeline 丢掉那个 item。舰队不整船沉。合并前先过滤。

2. 续跑靠本子，不靠聊天记忆

journal 按 agent() 召唤顺序记账。续跑回放最长未改前缀；碰到第一处改动，后面全实跑。真 JS 运行时禁 Date.now() / Math.random()，免得本子对不齐——教学脚本也请写成确定性的。

  journal  [A] [B] [C] [D]
  续跑      命中 命中 ✂ 实跑

3. 一个样本：分发 + 对抗

review-changes 不是「一种模式」，是 Fanout 里嵌 Adversarial：多维度 pipeline(audit, verify)，验证里再 parallel 挑刺，只留站得住的 finding。

  correctness ── 审计 ── 验证 ──┐
  security    ── 审计 ── 验证 ──┤── confirmed
  performance ── 审计 ── 验证 ──┤
  style       ── 审计 ── 验证 ──┘

# code.py 节选 — 形状就这些
async def sample_workflow(ctx, args):
    ctx.phase("Review")
    results = await ctx.pipeline(DIMENSIONS, audit, verify)
    confirmed = [f for r in results if r for f in r["confirmed"]]
    return {"confirmed": confirmed}

舰队不能早停，作者不当裁判，拓扑也不靠 chat 每轮改写。

六种常见形状（模式库）

模式	人话	原语速写
Classify-And-Act	先分拣再交给对的人	`agent` → 分支 → `agent`
Fanout-And-Synthesize	拆开干，再合并	`pipeline` / `parallel` → 汇总
Adversarial Verification	别让狐狸评鸡窝	产出 → `parallel(verify)` → 过滤
Generate-And-Filter	先多产再筛	`parallel(gens)` → 过滤
Tournament	两两比出冠军	裁判 `agent`
Loop Until Done	「还有新发现？」就继续	`while` + 停止 + `budget`

review-changes ≈ Fanout + Adversarial。研究类常叠：分发 → 过滤 → 验证 → 汇总。

动态 / 已保存 / 静态 & 官方原语图

# 教学示意
Workflow({ "name": "review-changes", "args": { "changes": "..." } })
# Claude Code 还接受：script | scriptPath | resumeFromRunId

不可信输入时：隔离读写

读工单的人，不该同时握着开 PR 的钥匙。读者只读 → 摘要；受信任的一侧只看摘要行动。

  积压 → [隔离区: 读 / 去重 / 摘要] → [受信任: 行动]

谁握计划？s06 一次性派工，s13 邮箱同伴，s15 单循环聊天，s16 是脚本 + journal，s17 在门口问整件事做完没有。普通改几个文件：s15 或一个 s06 往往够。Workflow 贵在 token 和协调——结构必须比单次对话活得更久时再用。

试一试

python s16_workflow_runtime/code.py demo
python s16_workflow_runtime/code.py resume

第一次看 Review → Verify；第二次同一 run，agent 应大量 cached（理想情况 agents=0 tokens=0）。想挂进完整宿主：不加参数直接跑 code.py。

s15 还是那个循环；这里只是多了一个 Workflow 工具。s17 问另一个问题：该停了吗？

5.5 KiB Raw Blame History Unescape Escape

s16: Workflow Runtime — 把编排写进代码

问题

解决方案

工作原理

试一试

5.5 KiB

Raw Blame History