一套骨架,两条路径:把"顺利路"和"排障路"装进同一个技能
一套骨架,两条路径:把"顺利路"和"排障路"装进同一个技能
新系列第三篇。前两篇分别是"三重门的实录"和"排障技能的决策树"。这一篇做合并:用同一份 SKILL.md 骨架,同时承载"顺利走通"和"卡住排障"两条路径——因为现实中它们从来不是两件事,而是一条路上的两种状态。
一、分家的代价
先说我走过的弯路。起初我把"交付流程"(五阶段流水线)和"排障决策树"写成了两个技能。听起来职责清晰,实际用起来立刻出问题:
排障时,Agent 看不到主流程的上下文。 它拿到"429"的症状,按排障技能给出"停止、等窗口、单次重试"——但它不知道当前处在第几个阶段、已经生成了哪些材料、上一步的判定标准是什么。于是它停下来问用户,用户也不知道,一来一回又是十几分钟。
反过来,主流程技能遇到失败时,只会给出"阶段失败,请重试"——没有分支,Agent 只能原地重试,重试到触发循环检测。
两条路分家,交接处就是断点。 这和我们在三重门里看到的"平台策略叠加"是同构的:每个部分单独合理,接缝处让人掉下去。
二、合并的核心:每个 Phase 都带"出口"
合并后的骨架只有一种结构:Phase 带着两条出口——“通过"与"失败”,失败出口指向一棵决策树。
Phase N: <阶段名>
动作: ...
判定: <硬门槛,达标才进入 N+1>
├─ 通过 → Phase N+1
└─ 失败 → 查错误码映射表 → 进入对应决策树 → 处理后回到 Phase N 重新判定
关键设计点有三条:
1. 失败分支不是"重试",是"分流"
每个失败分支必须写明具体症状 → 具体动作,而不是"失败后重试"。比如:
- 判定失败 + 错误码 A → 后台重试循环(节点池类)
- 判定失败 + 错误码 B → 强制重置后重连(中间态类)
- 判定失败 + 输出被脱敏 → 进入决策树一(凭证类)
- 判定失败 + 资源不可访问 → 进入决策树二(可达性类)
- 判定失败 + 429 → 进入决策树三(限流类)
"重试"是一个决策树的结果,永远不是默认动作。
2. 错误码映射表是两条路径的共享资产
主流程写"可能出现哪些错误码",决策树写"每个码怎么处理"——但表只维护一份。Agent 在任何一个 Phase 碰到码,查同一张表,得到同一个动作。这份共享表是合并的真正黏合剂。
3. 两条路径从同一个动作开始:先看状态
无论顺利还是排障,第一步都是"查状态接口"。主流程用它确认前置条件(实名/协议/凭据形式/CLI 版本),排障用它定位问题域(凭据是哪一种形式、配额还剩多少、当前环境是什么形态)。
"先看状态,再动手"是两条路径共同的起手式——这句话写进骨架的开头,比写在任何一棵树里都有用。
三、骨架示例(节选)
## 主流程
### Phase 1 创作与自查
动作: 生成产物 → 隐私自查(真实值清单逐项归零)
判定: 清单 0 命中;产物可最小运行
失败: 发现敏感值 → 换虚构值(禁止从会话历史复制样例)
### Phase 2 部署与验证
动作: 连接环境 → 检查前置 → 上传(MD5) → 部署 → 暴露 → 两端验证
判定: 公网 200 且 Content-Length 一致
失败分支:
- 节点池满载 → 决策树[容量]
- 实例中间态 → 决策树[重置]
- 配置丢失(休眠) → 重建配置+reload+重暴露(URL 会变)
### Phase 3 分发与提交
动作: 技能市场 → SkillHub → 展览馆(各自门禁)
判定: 每个平台拿到明确回执
失败分支:
- 凭证字段被脱敏 → 决策树[凭证]
- 资源"不可访问" → 决策树[可达性]
- 429 → 决策树[限流]
- 同名冲突 → 三选一(禁止自动改名)
## 决策树库(共享)
[容量] [重置] [凭证] [可达性] [限流] ...
## 错误码映射表(共享)
| 症状 | 判定 | 动作 | 回到哪个 Phase |
## 边界(两条路径共用)
- 需要用户提供凭据/换平台/等平台适配时,明确交接
- 凭证零残留、产物双写归档
四、为什么"合并"比"拆分"更符合 Agent 的工作方式
Agent 和人类工程师有个关键差异:人类的上下文在脑子里,Agent 的上下文在加载的文档里。
人类分两个技能手册没问题,遇到问题是人自己知道"我现在在第三步,第几步的材料已经齐了"。Agent 不行——它加载哪份文档,就只能看到那份文档的上下文。把两条路径并进一份文档,Agent 在每一步都同时看见"正常长什么样"和"这里出错怎么办",这正是它需要的。
这也回答了上一篇留下的问题:技能的价值不在覆盖面,而在同一时刻能提供多少相关上下文。
五、自测矩阵
合并后的技能必须双路自测:
| 路径 | 用例 | 期望 |
|---|---|---|
| 顺利 | 完整跑一遍交付(五阶段) | 每阶段通过、无多余动作 |
| 凭证失败 | 注入"输出为 redacted"症状 | 进决策树[凭证],引导到状态接口而非反复审批 |
| 可达性失败 | 注入"报不可访问" | 进决策树[可达性],引导到匿名实测三连 |
| 限流失败 | 注入 429 | 进决策树[限流],输出停止/等待/单次 |
| 状态丢失 | 模拟工具/凭证失踪 | 按状态管理清单重建,不误判为配置错误 |
五条全绿,才算合并成功。任何一条里出现"跳过判定直接重试",就是结构漏洞。
六、结语
从"三重门实录"到"排障决策树"到这篇"双路径合并",三步走完了一个技能从经历到产品的完整转化。
但还有一个没被覆盖的角色:用户。整个系列里,用户在某个时刻必须提供凭据、点击授权、确认发布——这些"人在回路"的节点,怎么在技能里定义清楚?这是下一篇的主题:人机交接点的设计——哪些必须人做、怎么做才不打断流程、交接失败怎么办。
本系列:①《一个发布请求卡了三天》②《把三天的破局压缩成十分钟》③本文。前序方法论系列"AI Agent 全链路交付"十一篇见文末标签。
- 点赞
- 收藏
- 关注作者
评论(0)