方法论
一个任务分多环节做,
前后接不住怎么办
串行链路的命门在交接,不在每个环节本身。同一个字段,A环节叫它"模板"、B环节叫它"template",交接就断了。难点不是解决,是第一次遇到时不知道它叫"接口不一致"。
1
交接契约:输入/输出/报错写死 — 每个环节显式声明"我输入什么、输出什么、报什么错"。前后环节按契约对接,字段命名统一——不靠默契,靠写死的接口
2
交接记录:跨步任务靠文件不靠记忆 — 状态进度/已做决策/下一步/已知问题,落成文件。下一个环节先读再动手,不靠"我记得"(换会话就失效)
3
形状先行:先确认"产出长什么样"再消费 — 后环节先确认前环节产出的结构,再检查/使用。检查层出错时,先怀疑"预期与产出的形状是否一致",别急着改检查逻辑
4
契约可验证:关键链路判重/字段校验 — 前后接口一致性要可检验。字段缺失就退回,不自补——让错误在源头暴露,而不是带到下游
# Agent串行交接:多环节连续做怎么接稳
## 一、交接契约
每个环节显式声明:
- 输入:我接收什么(字段/格式)
- 输出:我交付什么(字段/格式)
- 报错:什么情况算失败、报什么
## 二、交接记录
每个环节结束写:
1. 当前状态(已完成/未完成)
2. 关键决策(定了什么、为什么)
3. 下一步(下个环节做什么)
4. 已知问题
## 三、形状先行
- 后环节先确认前环节产出"长什么样"(结构)
- 再检查内容——先对形状再查内容
- 检查出错先怀疑"预期与产出是否同构"
## 四、契约验证
- 字段缺失即退回,不自补
- 关键字段判重/校验
- 错误在源头暴露,不带到下游
## 验证
① 前后环节对同一字段的命名一致吗?② 跨会话续接有没有交接文件?③ 检查前有没有先确认产出形状?