本文介绍了谷歌工程师研究的5种Skill开发黄金法则，包括工具封装器、生成器、审查器、反转和流水线模式。这些模式帮助开发者更好地构建Agent，解决内容设计挑战。文章提供了可运行的ADK代码示例，指导开发者如何应用这些模式，从而停止将复杂指令塞入单一系统提示词，转而构建更智能、可靠的Agent。

提到 𝚂𝙺𝙸𝙻𝙻.𝚖𝚍，开发者往往会专注于格式：确保 YAML 格式正确无误、构建目录结构以及遵循规范。

但是，随着超过 30 种 Agent 工具（如 Claude Code、Gemini CLI 和 Cursor）在同一套布局上实现标准化，格式问题实际上已经不存在了。

现在的挑战在于内容设计。

规范虽然解释了如何打包一个 Skill，但对于如何构建其内部的逻辑却未提供任何指导。

例如，一个封装 FastAPI 约定的 Skill 与一个包含四个步骤的文档处理流水线（pipeline）运作方式截然不同，尽管它们的 𝚂𝙺𝙸𝙻𝙻.𝚖𝚍 文件在外观上看起来一模一样。

通过研究整个生态系统中（从 Anthropic 的代码库到 Vercel 和 Google 的内部指南）是如何构建这些 Skill 的，我们发现了 5 种反复出现的设计模式，它们可以帮助开发者更好地构建 Agent。

每一种模式，附带可运行的 ADK（Agent Development Kit，智能体开发套件）代码：

• 工具封装器（ToolWrapper）：让你的 Agent 瞬间成为任何代码库的专家
• 生成器（Generator）：从可复用的模板生成结构化文档
• 审查器（Reviewer）：根据严重程度对照清单对代码进行评分
• 反转（Inversion）：Agent 在执行操作前先对你进行访谈
• 流水线（Pipeline）：强制执行带有检查点的严格多步骤工作流

模式 1：工具封装器（The ToolWrapper）

工具封装器为你的 Agent 提供关于特定代码库的按需上下文。

你无需将 API 约定硬编码到系统提示词（system prompt）中，而是将它们打包成一个 Skill 。你的 Agent 只有在实际使用该技术时才会加载这个上下文。

这是最容易实现的模式。𝚂𝙺𝙸𝙻𝙻.𝚖𝚍 文件会监听用户提示词中特定代码库的关键字，从 𝚛𝚎𝚏𝚎𝚛𝚎𝚗𝚌𝚎𝚜/ 目录动态加载你们的内部文档，并将这些规则作为绝对真理来应用。

这正是你将团队的内部编码指南或特定框架最佳实践直接分发到开发者工作流中所使用的机制。

以下是一个工具封装器的示例，它教 Agent 如何编写 FastAPI 代码。请注意，指令中明确告诉 Agent 只有在开始审查或编写代码时，才去加载 𝚌𝚘𝚗𝚟𝚎𝚗𝚝𝚒𝚘𝚗𝚜.𝚖𝚍 文件：

模式 2：生成器（The Generator）

工具封装器侧重于应用知识，而生成器则用于强制执行一致的输出。

如果你正苦恼于 Agent 每次运行都会生成不同的文档结构，生成器可以通过精心编排的“填空”过程来解决这个问题。

它利用了两个可选的目录：𝚊𝚜𝚜𝚎𝚝𝚜/ 用于存放你的输出模板，而 𝚛𝚎𝚏𝚎𝚛𝚎𝚗𝚌𝚎𝚜/ 用于存放风格指南。

指令在这里充当项目经理的角色。它们告诉 Agent 加载模板、阅读风格指南、向用户询问缺失的变量，并填充文档。

这对于生成可预测的 API 文档、标准化提交信息（commit messages）或搭建项目架构非常实用。

在这个技术报告生成器的示例中， Skill 文件本身并不包含实际的排版或语法规则。它仅仅负责协调这些资产的检索，并强制 Agent 逐步去执行它们：

模式 3：审查器（The Reviewer）

审查器模式将“检查什么”与“如何检查”分离开来。

你无需编写冗长的系统提示词来详细说明每一个代码异味（code smell），而是将模块化的评分标准存储在 𝚛𝚎𝚟𝚒𝚎𝚠-𝚌𝚑𝚎𝚌𝚔𝚕𝚒𝚜𝚝.𝚖𝚍 文件中。

当用户提交代码时，Agent 会加载此清单并有条理地对提交内容进行评分，按严重程度将其发现进行分组。

如果你将 Python 代码风格检查清单替换为 OWASP 安全检查清单，你就可以使用完全相同的 Skill 基础设施，获得一个截然不同且高度专业化的审计过程。

这是一种非常有效的方法，可以自动化 PR 代码审查，或者在人工查看代码之前捕捉到漏洞。

下面的代码审查器 Skill 演示了这种分离机制。指令保持静态不变，但 Agent 会从外部清单动态加载特定的审查标准，并强制输出基于严重程度的结构化结果：

模式 4：反转（Inversion）

Agent 往往本能地想要立刻进行猜测并生成结果。

反转模式颠覆了这种动态逻辑。不再是用户驱动提示词而 Agent 去执行，而是由 Agent 扮演面试官（访谈者）的角色。

反转模式依赖于明确的、不容妥协的门控指令（例如“在所有阶段完成之前，切勿开始构建”），以强制 Agent 首先收集上下文。

它会按顺序提出结构化问题，并等待你的回答，然后再进入下一个阶段。

在全面掌握你的需求和部署约束条件之前，Agent 会拒绝合成最终的输出结果。

想要了解实际效果，可以看看下面这个项目规划器 Skill 。此处的关键要素是严格的阶段划分和明确的把关提示词，它能够阻止 Agent 在收集完所有用户回答之前合成最终计划：

模式 5：流水线（The Pipeline）

对于复杂的任务，你无法承受遗漏步骤或无视指令所带来的后果。

流水线模式强制执行一个带有硬性检查点（hard checkpoints）、严格按顺序执行的工作流。

指令本身即作为工作流定义。通过实现明确的菱形门控条件（diamond gate conditions）（例如，要求在从生成文档字符串进入最终组装阶段之前必须得到用户批准），流水线确保了 Agent 无法绕过复杂任务并直接给出一个未经充分验证的最终结果。

此模式利用了所有可选目录，仅在需要的特定步骤才提取相应的参考文件和模板，从而保持上下文窗口的干净整洁。

在这个文档处理流水线示例中，请注意那些明确的门控条件。我们明确禁止 Agent 进入组装阶段，除非用户先确认了上一步生成的文档字符串：

每种模式都解决了不同的问题。使用下图这个决策树来为你的用例寻找正确的模式：

这些模式并不是相互排斥的。它们可以进行组合。

一个流水线（Pipeline） Skill 可以在最后包含一个审查器（Reviewer）步骤，以复查其自身的工作。

一个生成器（Generator）可以在最开始依赖反转（Inversion）模式收集必要的变量，然后再填充它的模板。

得益于 ADK 的 𝚂𝚔𝚒𝚕𝚕𝚃𝚘𝚘𝚕𝚜𝚎𝚝 和渐进式披露（progressive disclosure）机制，你的 Agent 只会在运行时为它实际需要的特定模式去消耗上下文 token。

停止尝试将复杂且脆弱的指令全部塞进单一的系统提示词中吧。

拆分你的工作流，应用正确结构的设计模式，并构建可靠的 Agent。

Agent Skills 规范是开源的，并已在整个 ADK 生态中得到原生支持。

你已经了解了如何进行格式打包。现在你也掌握了如何设计其内容。现在，去使用 Google Agent Development Kit 构建更智能的 Agent 吧。

如何学习大模型 AI ？

由于新岗位的生产效率，要优于被取代岗位的生产效率，所以实际上整个社会的生产效率是提升的。

但是具体到个人，只能说是：

“最先掌握AI的人，将会比较晚掌握AI的人有竞争优势”。

这句话，放在计算机、互联网、移动互联网的开局时期，都是一样的道理。

我在一线科技企业深耕十二载，见证过太多因技术卡位而跃迁的案例。那些率先拥抱 AI 的同事，早已在效率与薪资上形成代际优势，我意识到有很多经验和知识值得分享给大家，也可以通过我们的能力和经验解答大家在大模型的学习中的很多困惑。我们整理出这套 AI 大模型突围资料包：

• ✅ 从零到一的 AI 学习路径图
• ✅ 大模型调优实战手册（附医疗/金融等大厂真实案例）
• ✅ 百度/阿里专家闭门录播课
• ✅ 大模型当下最新行业报告
• ✅ 真实大厂面试真题
• ✅ 2026 最新岗位需求图谱

所有资料 ⚡️ ，朋友们如果有需要 《AI大模型入门+进阶学习资源包》，下方扫码获取~

① 全套AI大模型应用开发视频教程

（包含提示工程、RAG、LangChain、Agent、模型微调与部署、DeepSeek等技术点）

② 大模型系统化学习路线

作为学习AI大模型技术的新手，方向至关重要。 正确的学习路线可以为你节省时间，少走弯路；方向不对，努力白费。这里我给大家准备了一份最科学最系统的学习成长路线图和学习规划，带你从零基础入门到精通！

③ 大模型学习书籍&文档

学习AI大模型离不开书籍文档，我精选了一系列大模型技术的书籍和学习文档（电子版），它们由领域内的顶尖专家撰写，内容全面、深入、详尽，为你学习大模型提供坚实的理论基础。

④ AI大模型最新行业报告

2025最新行业报告，针对不同行业的现状、趋势、问题、机会等进行系统地调研和评估，以了解哪些行业更适合引入大模型的技术和应用，以及在哪些方面可以发挥大模型的优势。

⑤ 大模型项目实战&配套源码

学以致用，在项目实战中检验和巩固你所学到的知识，同时为你找工作就业和职业发展打下坚实的基础。

⑥ 大模型大厂面试真题

面试不仅是技术的较量，更需要充分的准备。在你已经掌握了大模型技术之后，就需要开始准备面试，我精心整理了一份大模型面试题库，涵盖当前面试中可能遇到的各种技术问题，让你在面试中游刃有余。

以上资料如何领取？

为什么大家都在学大模型？

最近科技巨头英特尔宣布裁员2万人，传统岗位不断缩减，但AI相关技术岗疯狂扩招，有3-5年经验，大厂薪资就能给到50K*20薪！

不出1年，“有AI项目经验”将成为投递简历的门槛。

风口之下，与其像“温水煮青蛙”一样坐等被行业淘汰，不如先人一步，掌握AI大模型原理+应用技术+项目实操经验，“顺风”翻盘！

这些资料真的有用吗？

这份资料由我和鲁为民博士(北京清华大学学士和美国加州理工学院博士)共同整理，现任上海殷泊信息科技CEO，其创立的MoPaaS云平台获Forrester全球’强劲表现者’认证，服务航天科工、国家电网等1000+企业，以第一作者在IEEE Transactions发表论文50+篇，获NASA JPL火星探测系统强化学习专利等35项中美专利。本套AI大模型课程由清华大学-加州理工双料博士、吴文俊人工智能奖得主鲁为民教授领衔研发。

资料内容涵盖了从入门到进阶的各类视频教程和实战项目，无论你是小白还是有些技术基础的技术人员，这份资料都绝对能帮助你提升薪资待遇，转行大模型岗位。

以上全套大模型资料如何领取？