4.1 KiB
4.1 KiB
title, type, tags, date, sources, last_updated
| title | type | tags | date | sources | last_updated | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| Google 5个 Agent Skill 设计模式 | source |
|
2026-03-19 | 2026-05-15 |
Source File
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 种模式正是这一理念的具体实现方式