指南
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 里的触发与不触发示例跑一遍。
新手常犯的四个错误
第一次写 Skill 时，下面这几条几乎人人都会踩。
一开始就写太宽"帮忙处理报告"不是一个任务。收窄到一句话能说清的一件具体事情。
最后才写描述描述决定激活与否，应该先写，用它来约束范围。
把所有内容都塞进主文件长参考资料应该放在按需读取的文件里，而不是主指令文件里。
跳过失败测试如果从不检查"不该激活"的情况，它以后一定会乱触发。