一套骨架,两条路径:把"顺利路"和"排障路"装进同一个技能

举报
yd_259466337 发表于 2026/11/15 11:05:57 2026/11/15
【摘要】 一套骨架,两条路径:把"顺利路"和"排障路"装进同一个技能新系列第三篇。前两篇分别是"三重门的实录"和"排障技能的决策树"。这一篇做合并:用同一份 SKILL.md 骨架,同时承载"顺利走通"和"卡住排障"两条路径——因为现实中它们从来不是两件事,而是一条路上的两种状态。 一、分家的代价先说我走过的弯路。起初我把"交付流程"(五阶段流水线)和"排障决策树"写成了两个技能。听起来职责清晰,实...

一套骨架,两条路径:把"顺利路"和"排障路"装进同一个技能

新系列第三篇。前两篇分别是"三重门的实录"和"排障技能的决策树"。这一篇做合并:用同一份 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 全链路交付"十一篇见文末标签。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。