No.7

来源: https://x.com/GoogleCloudTech/status/2033953579824758855

作者: Google Cloud Tech (@Saboo_Shubham_ 和 @lavinigam)

发布时间: 2026-03-18 01:08 AM

摘要

当谈到 SKILL.md 时，开发者往往执着于格式——YAML 是否正确、目录结构是否合理、是否遵循规范。但随着超过 30 种 Agent 工具（如 Claude Code、Gemini CLI 和 Cursor）都采用相同的布局，格式问题实际上已经解决了。现在的挑战是内容设计。规范解释了如何打包一个 skill，但完全没有指导如何构建内部的逻辑结构。例如，一个包装 FastAPI 规范的 skill 和一个四步文档管道的运作方式完全不同，尽管它们的 SKILL.md 文件外观几乎一样。通过研究生态系统中 skills 的构建方式——从 Anthropic 的仓库到 Vercel 和 Google 的内部指南——我们发现了五种反复出现的设计模式，可以帮助开发者构建更好的 agent。

核心内容

五种 Agent Skill 设计模式

模式 1：工具包装器 (Tool Wrapper)

工具包装器为你的 agent 提供特定库的按需上下文。与其将 API 规范硬编码到系统提示中，不如将它们打包成一个 skill。你的 agent 只有在实际使用该库时才会加载这个上下文。

这是最简单的实现模式。SKILL.md 文件监听用户提示中的特定库关键词，从 references/ 目录动态加载内部文档，并将这些规则作为绝对真理应用。这正是你将团队内部编码规范或特定框架最佳实践直接分发到开发者工作流中的机制。

模式 2：生成器 (Generator)

虽然工具包装器应用知识，但生成器强制执行一致的输出。如果你苦于 agent 每次运行都生成不同的文档结构，生成器通过编排一个"填空"过程来解决这个问题。

它利用两个可选目录：assets/ 存放输出模板，references/ 存放风格指南。指令充当项目经理，告诉 agent 加载模板、阅读风格指南、询问用户缺失的变量，然后填充文档。这适用于生成可预测的 API 文档、标准化提交信息或搭建项目架构。

模式 3：审查器 (Reviewer)

审查器模式将"检查什么"与"如何检查"分离。与其写一个长长的系统提示详细说明每个代码异味，不如将模块化的评分标准存储在 references/review-checklist.md 文件中。

当用户提交代码时，agent 加载这个检查表并系统地评分提交，按严重程度分组发现的问题。如果你将 Python 风格检查表换成 OWASP 安全检查表，你就能得到一个完全不同的专业审计，使用完全相同的 skill 基础设施。这是自动化 PR 审查或在人工审查前发现漏洞的高效方式。

模式 4：反转 (Inversion)

Agent 天生倾向于猜测和立即生成。反转模式翻转这种动态。用户不再驱动提示而 agent 执行，而是 agent 充当采访者。

反转依赖于明确的、不可协商的门槛指令（如"在所有阶段完成之前不要开始构建"）来强制 agent 先收集上下文。它按顺序提出结构化问题，等待你的答案后才进入下一阶段。agent 拒绝合成最终输出，直到它对你的需求和部署约束有了完整的了解。

模式 5：管道 (Pipeline)

对于复杂任务，你不能容忍跳过步骤或忽略指令。管道模式强制执行严格的顺序工作流和硬检查点。

指令本身充当工作流定义。通过实现明确的菱形门槛条件（如要求用户批准才能从文档字符串生成进入最终组装），管道确保 agent 不能绕过复杂任务并呈现未验证的最终结果。

这个模式利用所有可选目录，只在特定步骤需要时才拉入不同的参考文件和模板，保持上下文窗口干净。

模式可以组合

这些模式不是互斥的，它们可以组合。

管道 skill 可以在最后包含一个审查器步骤来复查自己的工作
生成器可以在最开始依赖反转来收集必要的变量，然后再填充模板
借助 ADK 的 SkillToolset 和渐进式披露，你的 agent 只在运行时花费上下文 token 在它需要的精确模式上

停止试图将所有复杂且脆弱的指令塞进单个系统提示。分解你的工作流，应用正确的结构模式，构建可靠的 agent。

开始使用

Agent Skills 规范是开源的，原生支持 ADK。你已经知道如何打包格式了，现在你知道如何设计内容了。去用 Google Agent Development Kit 构建更智能的 agent 吧。

收藏时间：2026-03-18 21:57 原文链接: https://x.com/GoogleCloudTech/status/2033953579824758855

每个 ADK 开发者都应该知道的 5 种 Agent Skill 设计模式

AI 核心摘要

摘要