指南
Skill 入门
理解 Skill 不是背概念,而是学会把重复任务打包成可激活的流程。
Skill 解决什么问题
Agent 往往懂通用语言和代码模式,但并不知道你团队的工作流、领域规则、输出格式和验证步骤。Skill 就是把这些可重复的经验打包起来。
基础目录
Skill 的起点是 SKILL.md。这个文件告诉 Agent 什么时候用这个 Skill,以及要按什么步骤做。
my-skill/ ├── SKILL.md ├── references/ ├── scripts/ └── assets/
激活是怎么发生的
Agent 先只看到 Skill 名称和简介;如果任务匹配,再加载完整说明。其他文件只有在 Skill 明确要求时才会读。
展示给 Agent 的目录信息: name: release-notes description: 根据合并的 PR、提交记录或 changelog,撰写面向客户的发布说明。 用户请求: "把这些合并的 PR 写成发布说明。" Agent 动作: 加载 .agents/skills/release-notes/SKILL.md,并按工作流执行。
练习路线
学 Skill 最好的方式,就是做一个小文件夹,测试激活,再根据失败结果持续改进。
1
做第一个 Skill
先从 Skill 快速开始 复制目录和 SKILL.md。
2
看清文件结构
读 Skill 结构,让 references、scripts、assets 各司其职。
3
自己写一个
拿 Skill 模板 当起点。
4
做评估
用 评估 Skill 里的触发与不触发示例跑一遍。