主题
什么是 Agent Skill
Agent Skill 就是给 Agent 看的说明书。
2025 年 12 月,Anthropic 把 Agent Skills 作为跨平台的开放标准正式发布。它要解决的是一个很实际的问题:当我们把任务交给 Agent 时,它并不清楚我们的习惯和偏好——无论内容还是格式,都很难一次就给出我们想要的结果。按提示词工程的做法,我们每次提问都得附上一大段要求,既重复又麻烦。
Agent Skill 的思路很直接:把这些反复要交代的"要求"一次性写成一份文档存起来,需要时让 Agent 自己去读。本质上,一个 Skill 就是一份 markdown 文档(SKILL.md),结构分两部分——上半部分是元数据层,声明这个 Skill 叫什么、负责做什么;下半部分是指令层,把要做的事、规则、格式、示例讲清楚即可,没有严格格式要求。

Skill 是如何被调用的
一个很自然的问题是:如果配置了很多个 Skill,Agent 怎么知道该用哪一个?会不会把所有 Skill 的内容一股脑塞给大模型,把上下文撑爆?
答案是不会。Claude Code 在把用户请求发给大模型时,只会附上所有 Skill 的一份"清单",而清单里每个 Skill 只有名称和描述两项,并不包含具体内容。大模型根据这份清单来判断:这次任务要不要用 Skill、该用哪个。比如用户说"帮我总结会议内容",大模型看到清单里有个"会议总结助手",描述正好对得上,就会选中它。只有到这一步,Claude Code 才会把这个 Skill 的完整内容(SKILL.md)加载进来给大模型看。

如何创建一个 Skill
Skill 的创建有明确的格式要求。在项目的 .claude/skills 文件夹下,新建一个子文件夹,文件夹的名称要和 Skill 里定义的 name 保持一致;再在这个子文件夹里新建一个 SKILL.md 文件,把 Skill 的全部内容写进去并保存。这样 Agent 才能识别到我们配置的这个技能。
skill和subagent的区别是什么
Agent 是厨师,Skill 是菜谱。菜谱自己炒不出菜,但厨师照着菜谱,能把一道菜稳定复刻。而且同一个厨师能查很多本菜谱,同一本菜谱也能给很多厨师用——Skill 和 Agent 就是这种“多对多”的关系。(换成“员工 vs 员工手册”也一样。)
| 对比 | Agent(智能体) | Skill(技能包) |
|---|---|---|
| 本质 | 会做事的执行主体(大脑 + 循环) | 一份静态说明书(SKILL.md) |
| 类比 | 厨师 / 员工 | 菜谱 / 员工手册 |
| 有没有大脑 | 有,自己思考决策 | 没有,本身不推理 |
| 会不会主动行动 | 会,自主规划 + 调工具 | 不会,等着被读取 |
| 占不占独立上下文 | 占(subagent 有自己的上下文窗口) | 不占,按需加载进当前 Agent |
| 解决的问题 | 谁来干、怎么把多步任务跑完 | 干这类活遵循什么规范和经验 |
