Google 5 个 Agent Skill 设计模式
来源：Google Cloud Tech (@GoogleCloudTech)，2026-03-19 GitHub: https://github.com/google-gemini/gemini-skills
背景
SKILL.md 规范定义了如何封装一个 Skill，但对 Skill 内部逻辑的结构没有任何指导。例如，封装 FastAPI 约定的 Skill 和一个四步骤文档生成流水线，尽管 SKILL.md 文件看起来一样，但内部运作方式完全不同。
这 5 个模式正是为了填补这个空白——帮助开发者在 Skill 内部构建有意义的逻辑结构。
5 个设计模式
1. Tool Wrapper（工具包装器）
一句话：让 Agent 即时成为某个特定库的专家。
原理：把 API 约定、最佳实践打包进 Skill，而不是硬编码在 system prompt 里。Agent 只在真正需要用到该技术时才加载这部分上下文。
适用场景：
- 封装特定框架的用法规范（如 FastAPI、React、Tailwind）
- 让 Agent 按需获取特定 SDK 的最新文档约定
- 降低常驻 context 占用
特点：5 个模式中最简单，入门首选。
2. Generator（生成器）
一句话：解决 Agent 每次生成不同结构文档的问题。
原理：通过"填空"流程编排输出。Skill 使用两个可选目录：
assets/：存放输出模板references/：存放风格指南
适用场景：
- 生成格式统一的 API 文档
- 标准化 commit message
- 项目架构脚手架生成
- 任何需要"每次输出格式一致"的场景
3. Reviewer（审查器）
一句话：将"检查什么"与"如何检查"分离。
原理：不在 system prompt 里堆砌检查规则，而是把模块化的评审标准存储在 references/review-checklist.md 文件中。Agent 加载清单，对提交内容打分，按严重程度分组输出。
适用场景：
- 自动化 PR 代码审查
- 安全漏洞扫描（换 OWASP 清单即可）
- 代码质量评估
- 将 Python 风格清单换成任意专项清单 → 获得完全不同的专项审计工具
亮点：同一套基础设施，换一个 checklist 文件，就变成完全不同的专项审计器。
4. Inversion（反转模式）
一句话：把 Agent 变成面试官，先问问题再动手。
原理：颠覆"用户驱动 prompt → Agent 执行"的常规模式。Skill 中包含明确的不可跳过指令（如"在所有阶段完成前 DO NOT 开始构建"），强制 Agent 先收集上下文：
- 按顺序提出结构化问题
- 等待用户逐一回答
- 获得完整需求图景后，才开始生成最终输出
适用场景：
- 需求澄清（产品设计、架构规划）
- 部署配置引导
- 任何"做错了成本高"的任务
5. Pipeline（流水线）
一句话：强制执行严格的多步骤工作流，带检查点。
原理：Skill 文件本身不包含实际内容（如布局规则、语法规范），而是负责协调各资产的检索，并强制 Agent 按步骤依次执行，每步都有明确的检查点。
适用场景：
- 多阶段内容生产（草稿→审校→排版→发布）
- 复杂工程流程（测试→Review→部署）
- 任何需要"强制顺序、不可跳步"的工作流
与现有工具的关系
| 工具 | 兼容性 |
|---|---|
| Claude Code | 原生支持 SKILL.md |
| Gemini CLI | 原生支持 |
| Cursor | 支持 |
| OpenClaw | 支持 |
| Codex | 支持 |
| 其他 30+ 工具 | 统一格式 |
模式选择决策树
需要让 Agent 成为某工具专家？
→ 是 → Tool Wrapper
→ 否 → 需要生成统一格式输出？
→ 是 → Generator
→ 否 → 需要审查/检查内容？
→ 是 → Reviewer
→ 否 → 需要先收集信息再执行？
→ 是 → Inversion
→ 否 → 需要严格多步骤流程？
→ 是 → Pipeline
关联
- claude-code/lessons-building-skills — Claude Code Skills 9 类分类体系
- harness-engineering/skills-into-loops — Skills Into Loops
- claude-code/overview — Claude Code Skill 系统