工具教程 · 小互解读

Google 在其 AI 开发框架 Genkit 中支持 Agent Skills,让 AI 能「按需挂载技能包」

Anthropic 发起的技能开放标准,Google 四个语言版本全接入;两个能跑的 Go 例子手把手,接入只要一行参数
一分钟速览
  • AI Agent 的说明书越堆越多,全塞进上下文既烧 Token 又让模型分心。Google 给自家框架 Genkit 接上了 Agent Skills:说明书放磁盘上,用到哪份调哪份。
  • 这套技能标准是 Anthropic 发起的,Google 四个语言版本全接,接入只要一行参数。
  • 官方拿 2012 年被毁容的「猴子耶稣」原画当测试题,模型自己认出是油画、唤出对应修复技能。
⚑ 材料来自 Google 开发者博客讲自家框架 Genkit 的教程;两个示例的运行效果为原文展示,本站未独立复跑。
痛点

说明书全塞给 AI,塞不下也没必要

Google 开发者博客发布了一份极其实用的上手教程:自家开源 AI 应用框架 Genkit 正式支持 Agent Skills,由 Anthropic 发起、已经开放成行业标准的「AI 技能包」格式。简单来说,过去你得把所有操作手册塞进提示词,现在手册躺在磁盘上,用到哪份才加载哪份,接入只要一行参数。教程用 Go 语言给了两个能直接跑的例子:一个菜谱机器人,一个会自己挑修复方案的 AI 艺术修复师。

4 种语言
TypeScript / Go / Dart / Python 版本全部接入
3 个阶段
渐进披露:发现 → 激活 → 执行
1 行参数
ai.WithUse(...) 即完成接入

它要解决的问题每个做 Agent 的人都撞过:Agent 接的活越多,要给它的说明书就越多,操作规程、参考指南、各种文档。全部常驻在上下文窗口里,三个毛病一起来:Token 白烧(每次请求都把整摞文档再读一遍)、注意力被稀释(真正相关的那几行淹在几百页里)、答错的概率反而上升。就像一个员工每天上班先把公司全部规章制度从头背一遍,其实他今天只用得上其中一页。

以前:全塞进上下文 操作规程 参考指南 品牌手册 审核清单 数据字典 更多文档…(塞不下还在来) 每次请求都整摞带上 现在:按需加载 技能名片 留给正事 磁盘 技能正文躺这里 点名才进来
同一摞说明书,两种放法:常驻上下文 vs 名片常驻、正文躺磁盘(本站示意图)

Agent Skills 解决的就是这件事:把专业知识打包成一个个技能,平时躺在后台,被用到的那一刻才加载。如果你用过 Claude Code 的 Skills,这套东西会非常眼熟,格式就是同一个,Anthropic 把它开放成了标准(agentskills.io),Genkit 这次接的正是这套。站内之前拆过 Anthropic 官方拿技能搭验证循环的实战:

站内相关
Anthropic 官方教你把手动代码检查写成技能,让它自己查自己修
技能这个东西在 Claude Code 里怎么真刀真枪地用,这篇有完整拆解;今天这篇讲的是同一套格式跑进了 Google 的框架。
格式

一个技能就是一个文件夹

那么这个「按需加载」的技能长什么样?答案简单得出乎意料:一个技能就是一个文件夹,里面必须有一份 SKILL.md 文件。这份文件分两截,头部 frontmatter,用 --- 围起来的一小段元数据,写着技能叫什么、什么时候该用我;正文 body,真正的操作指令。文件夹里还可以放三类可选资源:scripts/(可执行脚本)、references/(参考文档)、assets/(模板素材)。

技能文件夹标准结构(照这个建目录)
skill-name/
├── SKILL.md          # Required: metadata + instructions
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates, resources
└── ...               # Any additional files or directories
必需的只有 SKILL.md 一份;脚本、参考文档、模板素材都是可选的随身行李。
技能 = 一个文件夹 skill-name/ ├─ SKILL.md ├─ scripts/ ├─ references/ └─ assets/ ★ 必需 可执行脚本 参考文档 模板素材 SKILL.md 解剖 frontmatter · 名片 name:叫什么 description:什么时候用我 body · 操作指令 怎么干活的完整规程 可指向 references/ 与 scripts/ 常驻系统提示的,只有名片这一小截
SKILL.md 两截解剖:名片轻、正文重,轻的常驻、重的按需(本站示意图)