Google ADK：五种 Agent Skill 设计模式解决五类控制问题

SKILL.md 只规定了能力怎样被包装，真正决定 Agent 行为的是内部结构；Tool Wrapper、Generator、Reviewer、Inversion 和 Pipeline 分别解决知识、输出、质量、信息收集与流程顺序五类控制问题。

1. 原文说了什么

Agent Skills 的目录格式已经相对统一：frontmatter 描述名称与触发条件，正文保存指令，references/、assets/ 和 scripts/ 承载按需资源。但同一种格式可以表达完全不同的能力。给 Agent 注入 FastAPI 约定，与强制执行四阶段文档流程，显然不是同一种内部结构。

原文归纳了五种常见模式。

1. Tool Wrapper：按需注入专业知识

Tool Wrapper 把某个库、框架或内部工具的约定包装为可按需加载的参考。正文说明使用原则，references/ 保存详细规范。它适合“Agent 已会编程，但不知道我们怎样使用这个工具”的场景。

控制目标：让知识只在相关任务中出现，并覆盖模型的通用默认做法。

2. Generator：用模板稳定输出

Generator 使用 assets/ 保存输出模板，用 references/ 保存风格和质量规则，Skill 负责收集输入并填充所有必需章节。它适合报告、配置、脚手架、提交信息等结构必须稳定的产物。

控制目标：约束输出结构，同时保留内容生成的灵活性。

3. Reviewer：按标准检查并分级

Reviewer 把“检查什么”放进清单，把“怎样检查和报告”放进协议。它可以对代码、文档或配置逐项检查，按严重程度输出发现、原因与修改建议。

控制目标：把质量标准外置，使同一评审流程可以替换不同规则集。

4. Inversion：先由 Agent 采访用户

Inversion 反转常见交互：Agent 不立即生成结果，而是按阶段询问目标、用户、规模、约束和不可妥协条件，信息完整后再综合。它适合需求澄清、系统设计和复杂规划。

控制目标：在高不确定任务中延迟行动，先降低输入缺口。

5. Pipeline：用关卡约束顺序

Pipeline 把任务拆成有顺序的阶段，每一步完成并通过检查后才能继续。它通常同时使用参考资料、模板和脚本，并在阶段之间设置用户确认或程序验证。

控制目标：防止复杂流程跳步，并让每个阶段产生可检查的中间结果。

这五种模式可以组合。例如，Pipeline 的质量检查阶段可以嵌入 Reviewer；Generator 可以先用 Inversion 收集输入；Tool Wrapper 可以成为 Pipeline 某一步的知识来源。

2. 我是怎么理解的

五种模式表面上是不同的 SKILL.md 写法，实质上对应 Agent 系统的五个控制旋钮：

• Tool Wrapper 控制知识范围。
• Generator 控制产物形状。
• Reviewer 控制评价标准。
• Inversion 控制何时开始行动。
• Pipeline 控制行动顺序与阶段门禁。

这套分类的价值在于把“帮我写一个更强的 Prompt”改成一个更具体的问题：当前失败究竟来自缺知识、输出漂移、没有检查、信息不足，还是流程跳步？选错模式，即使指令写得很长，也只会在错误层面增加复杂度。

这些模式与 ADK 的渐进式披露相容，但并不局限于 ADK。只要 Agent 能根据描述加载目录，并按需读取资源，同样的结构也可以迁移到其他支持 Agent Skills 的工具。

3. 我的判断是什么

这五种模式提供了很好的设计词汇，尤其适合评审 Skill 时快速识别它试图解决的问题。我会优先选择复杂度最低、能覆盖主要失败的模式，再考虑组合。

但需要注意：它们主要是指令编写模式，并不自动等于运行时硬保证。Tool Wrapper、Generator 和 Reviewer 相对容易通过产物验证；Inversion 和 Pipeline 往往依赖模型服从“不要提前行动”“不得跳步”等文字约束。关键流程若只靠指令门禁，模型仍可能越过阶段。

因此，生产场景需要把软模式转换成可验证机制：

• 缺少必填信息时，由程序拒绝进入下一状态。
• Pipeline 的阶段状态保存在外部，而不是只存在对话里。
• Reviewer 使用结构化 schema 输出。
• 高风险步骤要求人工确认或独立权限。
• 每种模式都用正例、负例和端到端任务测试。

4. 可以怎么使用

可以用下面的决策顺序选择模式：

1. Agent 是否缺少某个库或组织的专业约定？选择 Tool Wrapper。
2. 输出是否必须每次遵循固定结构？选择 Generator。
3. 核心任务是否是按规则检查现有产物？选择 Reviewer。
4. 开始行动前是否必须向用户补齐大量信息？选择 Inversion。
5. 多个步骤是否有严格先后与验收关卡？选择 Pipeline。

如果同时满足多个条件，先确定主模式，再把其他模式嵌入局部步骤，不要把一个 Skill 写成五种模式的无边界集合。

落地时还可以给 frontmatter 增加团队自定义元数据，例如 pattern、domain 和风险等级，方便审计与统计；但这些字段不应挤占模型上下文，运行时可以按需要剥离。