---
title: "Google 5个 Agent Skill 设计模式"
type: source
tags: ["Agent", "Skill", "设计模式", "Google", "ADK"]
date: 2026-03-19
sources: []
last_updated: 2026-05-15
---

## Source File
- [[Agent/Google-5个Agent-Skill设计模式-2026-03-19.md]]

## Summary（用中文描述）
- 核心主题：Google ADK 发布的 5 种经过验证的 Agent Skill 设计模式，帮助开发者将复杂的工作流从脆弱的 system prompt 中解耦出来
- 问题域：Agent 开发中，SKILL.md 格式已标准化，但相同格式的 skill 执行效果差异巨大，问题出在内容设计上
- 方法/机制：5 种结构化设计模式（Tool Wrapper、Generator、Reviewer、Inversion、Pipeline），通过 SKILL.md 的目录结构（references/、assets/）和渐进式披露机制实现
- 结论/价值：这 5 种模式可组合使用，通过 ADK 的 SkillToolset 在运行时按需加载，只在需要时才消耗上下文 token

## Key Claims（用中文描述）
- Google ADK 的 SkillToolset 和渐进式披露机制，使得 agent 只在运行时需要时才加载特定的 skill 逻辑
- Tool Wrapper 模式通过监听特定库关键词，动态加载 references/ 目录下的规范文档，让 agent 在真正用到该技术时才加载相关规则
- Generator 模式通过 assets/（输出模板）和 references/（样式指南）两个目录，实现强制一致的文档结构输出
- Reviewer 模式将"检查什么"（references/review-checklist.md）和"怎么检查"（SKILL.md 指令）完全分离，同一 skill 基础设施换清单就是不同专项审计
- Inversion 模式通过明确的门控指令（如"不到所有阶段完成就不开始构建"），让 agent 变成面试官，先问你问题再行动
- Pipeline 模式通过硬性检查点（gating conditions）强制执行严格顺序工作流，确保 agent 无法绕过步骤直接给出未验证结果
- Anthropic 经验：最好的 Skill 不是写好的提示词，而是"工具箱"；写好 Skill 的三条铁律：只写 Agent 不知道的东西、重点写踩坑清单、给工具不给指令

## Key Quotes
> "别再把所有复杂又脆弱的指令塞进一个 system prompt了。把工作流拆分开，应用正确的结构模式，才能构建出真正可靠的 agent。" — 结论总结
> "Anthropic 把内部几百个 Skills 用了个遍，发现最好的 Skill 不是写得好的提示词，而是一个「工具箱」。" — Anthropic 的 Skill 实践

## Key Concepts
- [[ToolWrapper模式]]：将某个库或框架的规范文档打包成一个 skill，agent 只在用到该技术时才动态加载相关规则
- [[Generator模式]]：利用 assets/ 和 references/ 两个目录，通过"填空"流程生成结构化输出
- [[Reviewer模式]]：将审查标准（references/review-checklist.md）与检查逻辑（SKILL.md）完全分离
- [[Inversion模式]]：agent 先问你再做，通过门控指令强制 agent 逐阶段提问并等待用户回答
- [[Pipeline模式]]：带硬性检查点的严格顺序工作流，确保复杂任务无法跳过步骤
- [[渐进式披露]]：ADK 的 SkillToolset 机制，只在运行时按需加载需要的 skill 内容，按需消耗上下文 token
- [[SkillToolset]]：Google ADK 中的 skill 基础设施，支持目录结构和动态加载

## Key Entities
- [[Google ADK]]：Google Agent Development Kit，由 Saboo_Shubham_ 和 lavinigam 撰写，发布 5 种 Skill 设计模式指南
- [[Anthropic Claude Code]]：参考了 Anthropic 的 Skill 实践经验，Claude Code 是支持 SKILL.md 格式的主流工具之一
- [[Saboo_Shubham_]]：Google ADK Skill 设计模式指南作者之一
- [[lavinigam]]：Google ADK Skill 设计模式指南作者之一

## Connections
- [[Anthropic Claude Code]] ← 参考 ← [[Google 5个 Agent Skill 设计模式]]
- [[渐进式披露]] ← 由 ← [[Google ADK]]
- [[SkillToolset]] ← 属于 ← [[Google ADK]]
- [[Reviewer模式]] ← 可组合 ← [[Pipeline模式]]
- [[Generator模式]] ← 可组合 ← [[Inversion模式]]

## Contradictions
- 与 [[Anthropic Claude Code]] 不冲突：Anthropic 强调"给工具不给指令"，Google 的 5 种模式正是这一理念的具体实现方式