节点选择与搭建
按节点职责来搭 workflow，而不是凭感觉堆能力。
大多数 workflow 不是坏在“不会连线”，而是坏在“节点选错了”。
先用节点职责来想
不要先问“这个节点名字像不像我要的”。
先问它属于哪一类职责：
| 节点类型 | 典型作用 | 什么时候该选它 |
|---|---|---|
| Capability 节点 | 真正执行某个能力 | 需要读取、生成、转换、调用能力时 |
| Review / Approval 节点 | 在高风险动作前停下来 | 需要人工判断是否继续时 |
| Data operation 节点 | 变换、抽取、合并、排序数据 | 要整理节点之间的数据形状时 |
| Flow primitive 节点 | 分支、控制、路由 | 要决定流程往哪条路走时 |
| Browser 节点 / Browser projection | 规划或执行浏览器动作 | 真正要走网页、表单、上传、提交时 |
| Design / Note 节点 | 说明、注释、输入上下文、非运行结构 | 要给流程补说明、目标、输入或输出约束时 |
| Delivery 节点 | 组织最终交付结果 | 需要把结果输出成明确交付物时 |
一个常见的错误搭法
很多人会把所有需求都塞进 capability 节点。
结果就是：
- 分支逻辑写进提示词里；
- 数据整理写进模型说明里；
- 审批被放到最后；
- 画布上看起来节点不多，但实际很难维护。
更稳的做法是把职责拆开。
推荐搭建顺序
先放最终交付目标，反推前面需要哪些结果。
再放真正执行的 capability 节点。
中间需要整形数据的地方，再补 data operation。
有分支判断的地方，再补 flow primitive 或 condition。
所有外部后果动作前，补 review / approval。
最后再补 note、输入说明和画布整理。
怎么选 capability 节点
Capability 节点适合负责“真实动作”。
比如：
- 生成图片、视频、音频；
- 搜索、研究、分析、表格处理；
- 文档、交付物、浏览器动作；
- 连接外部系统读取或写入。
但 capability 节点不适合承担这些事：
- 流程分支；
- 大段人工注释；
- 纯数据整理；
- 该由审批决定的最终放行。
什么时候用 data operation
只要你发现自己在说这些话，就该考虑 data operation：
- “我先把上一步结果抽出几个字段”
- “把两个节点结果合并一下”
- “把列表排个序再给下游”
- “只把需要的内容传给后面的能力”
如果你把这些动作全塞到 capability 节点里，后面排错会很难。
什么时候用 flow primitive
Flow primitive 更像控制语义，不是业务结果本身。
它适合处理：
- 条件分支；
- 路径控制；
- 不同结果走不同后续；
- 明确的流程控制点。
它不适合拿来做复杂业务判断的“黑箱节点”。
如果你的分支条件连你自己都说不清，先别上 primitive，先把规则写清楚。
什么时候用 browser 节点
只有在动作真的要发生在网页或浏览器环境里时，才用 browser 路径。
例如：
- 打开页面；
- 填表；
- 上传文件；
- 提交表单；
- 截图取证；
- 观察页面结果。
如果只是“需要网页信息”，很多时候搜索、研究或普通读取能力就够了，不必一上来就走 browser。
什么时候放 approval / review
审批不要放在“最后收尾时顺便看一眼”。
审批要放在真正会产生后果的前面，比如：
- 提交前；
- 发布前；
- 发送前；
- 写入外部系统前；
- 删除或覆盖前。
一个好位置的审批，会让流程在错误发生前停下，而不是在事故发生后补救。
有些节点是运行型，有些不是
这点很关键。
工作流画布里可能同时存在：
- 真正可以参与运行的节点；
- 主要用于设计说明、注释或结构表达的节点。
所以看到一个节点出现在画布上，不代表它一定会以同样方式进入 runtime 执行。
这也是为什么：
- note 节点更适合解释流程；
- input / prompt / artifact_output 这类设计节点更适合明确上下文；
- 运行验证时要看节点是否真的参与执行。
节点选择的最低检查清单
- 这个节点是执行动作，还是控制路径？
- 这个节点是在处理数据，还是在调用能力？
- 这个节点会不会带来外部后果？
- 如果失败，我能不能快速判断该看这个节点还是前一个节点？
- 如果别人接手，他能不能一眼看懂这一步负责什么？
截图占位
后续建议补 4 张图：节点面板、节点类型示例、含审批的流程段、data operation / flow primitive 的典型放置位置。
录屏占位
后续建议补 1 段短录屏：从空白 workflow 开始，逐步加入 capability、data operation、approval 和 delivery。