5.6 KiB
title, source, author, published, created, description, tags
| title | source | author | published | created | description | tags |
|---|---|---|---|---|---|---|
| 继Anthropic后，Google放出5个常用的Agent Skill设计模式 | shenwei |
继Anthropic后，Google放出5个常用的Agent Skill设计模式
作者: winkrun 来源: https://mp.weixin.qq.com/s/yu120tW0l4DJAJfWmbJYxg 公众号: AI工程化 日期: 2026年3月19日 06:12 标签: Agent、Skill、设计模式、Google、Anthropic
如果你也在写Agent Skills，应该会发现一个尴尬的事实：SKILL.md的格式已经标准化了，三十多个主流工具（Claude Code、Gemini CLI、Cursor……）都支持同一种写法。格式不再是问题，但很多人写着写着就发现——同样格式的skill，执行效果天差地别。
问题出在内容设计上。同样是一个skill，包装FastAPI规范和实现一个四步文档流水线，内部的逻辑结构完全不同，但外在看起来一模一样。Google Cloud最新发布的这份指南，由Saboo_Shubham_和lavinigam撰写，就是专门解决这个问题的。
这份指南总结了五种经过验证的设计模式，每种都有完整的ADK代码示例。
Tool Wrapper：让agent快速成为某个领域的专家
这是最容易上手的模式。简单说，就是把某个库或框架的规范文档打包成一个skill，agent只有在真正用到这个技术时才会加载相关文档。
比如一个写FastAPI的skill，不需要把所有的API约定都塞进system prompt，而是让SKILL.md监听特定的库关键词，当用户开始写FastAPI代码时才动态加载references/目录下的conventions.md，把这些规则当作绝对真理来执行。
这特别适合分发团队内部的编码规范或者特定框架的最佳实践。
Generator：从模板生成结构化输出
如果Tool Wrapper是应用知识，Generator则是强制一致的输出格式。很多agent每次运行生成的文档结构都不一样，Generator通过一个"填空"流程解决这个问题。
它利用两个可选目录：assets/存放输出模板，references/存放样式指南。SKILL.md扮演项目经理的角色，指示agent加载模板、读取样式指南、向用户询问缺失的变量、然后填充文档。
这对于生成统一的API文档、标准化commit信息或者脚手架项目结构都非常实用。
Reviewer：把检查清单和检查逻辑分开
非常实用的模式之一。传统的代码审查会把所有规则都写进system prompt，结果越写越长。Reviewer模式把"检查什么"和"怎么检查"完全分开。
审查标准存放在references/review-checklist.md里，可以是Python风格检查，也可以换成OWASP安全检查——同样的skill基础设施，换个清单就是完全不同的专项审计。
代码示例展示了一个Python代码审查skill的结构。指令保持静态，但agent会动态加载特定的审查标准，并强制输出按严重程度分组的结构化结果。
Inversion：agent先问你再做
这是最反直觉的模式。Agent天生喜欢直接猜测和生成，Inversion把这个流程完全反过来——agent变成面试官，先问你一系列问题，等你回答完再行动。
关键在于明确、不可协商的门控指令（比如"不到所有阶段完成就不开始构建"）。Agent会逐个阶段提问，等待你的答案，然后才进入下一个阶段。
一个项目规划skill的示例展示了这一点：必须等用户回答完所有问题，agent才会加载plan-template.md并生成最终计划。
Pipeline：带硬性检查点的严格工作流
对于复杂任务，你承受不起跳过步骤或者忽略指令的情况。Pipeline模式强制执行严格的顺序工作流，并在关键节点设置硬性检查点。
指令本身定义了工作流。通过实现明确的门控条件（比如要求用户在进入下一步之前确认生成的文档字符串），Pipeline确保agent无法绕过复杂任务直接给出未验证的最终结果。
一个文档流水线的例子展示了四个步骤：解析和清点、生成文档字符串、组装文档、质量检查。每一步都有明确的前置条件，用户必须在进入下一步之前确认。
选择合适的模式
每个模型都有其应用场景，可以根据下图来判断使用合适的模式。
这些模式可以组合使用
这是容易被忽视的一点。这五种模式并非互斥，而是可以组合。Pipeline可以在最后包含一个Reviewer步骤来 double-check 自己的成果；Generator可以在最开始依赖Inversion来收集必要的变量。
多亏了ADK的SkillToolset和渐进式披露机制，agent只在运行时需要时才消耗上下文token来加载特定的模式。
别再把所有复杂又脆弱的指令塞进一个system prompt了。把工作流拆分开，应用正确的结构模式，才能构建出真正可靠的agent。
相关链接
- 原文：https://x.com/i/article/2033941492633362432
- awesome-agent-skills：https://github.com/skillmatic-ai/awesome-agent-skills
附录：Anthropic 的 Skill 实践
Anthropic 把内部几百个 Skills 用了个遍，发现最好的 Skill 不是写得好的提示词，而是一个「工具箱」。他们把 Skills 分成九类，从参考手册到故障排查，每类都有明确的场景。写好 Skill 的三条铁律：只写 Agent 不知道的东西、重点写踩坑清单、给工具不给指令。
- Anthropic工程师分享的Claude Code技能设计指南：9种类型与实战技巧 https://wink.run/pings/content/111668?from=wx