新手文章
用大白话解释 Agent Skill
讲清楚 Skill 是什么，以及它为什么不是普通提示词。
一个简单比喻
如果 MCP 是通往工具的门，那么 Skill 就是把事情做好的一张菜谱。它告诉 Agent 应该注意什么、按什么步骤做、读哪些资料、跑哪些脚本、最后输出应该长什么样。
普通提示词通常只贴在一次对话里。Skill 会被打包、命名、描述、版本化，并在很多任务里复用。
大白话版本
Skill 教的是做事步骤。它主要不是解决“能不能访问”，而是解决“该怎么做”。
Skill 里面有什么
Skill 的中心是 SKILL.md。这个文件说明什么时候应该激活这个 Skill，以及激活后 Agent 应该怎样做。更大的材料可以放到 references、scripts 和 assets 里。
release-notes-skill/
├── SKILL.md
├── references/
│ └── release-note-style.md
├── scripts/
│ └── collect_changes.js
└── assets/
└── release-template.mdSkill 怎样被激活
Skill 有用，是因为 Agent 不需要一开始就加载所有长指令。它先看到简短名称和描述；如果用户任务匹配，再加载完整 Skill。
1
用户提出任务
比如：“根据这些合并的 PR 写发布说明。”
2
Agent 检查可用 Skill
发布说明 Skill 的描述看起来匹配。
3
Agent 加载 Skill
读取详细步骤和必要参考资料。
4
Agent 完成工作
按 Skill 输出指定格式的结果。
新手为什么要关心
Skill 能避免团队在每次对话里重复粘贴长提示词，也让 Agent 行为更容易测试、改进和共享。
可重复同类任务按同一套步骤完成。
节省上下文长资料只在需要时加载。
沉淀团队经验好的内部流程可以打包一次，多处复用。
方便评估可以测试是否正确激活，以及输出质量是否达标。
为什么 Skill 从来不激活
新手最常见的失败不是 Skill 写坏了，而是 agent 根本没选择加载它。
描述在讲文件本身"一个放着指令的文件夹"没有告诉 agent 什么时候该用它。
范围太宽号称能帮忙"写作"的 Skill，最后要么到处都是，要么一次都不出现。
任务说法对不上如果描述瞄准的是没人会那样说的措辞，它就会一直沉睡。
正文太臃肿把所有东西都塞进
SKILL.md，会让激活路径变噪声，而不是按需加载参考资料。修改顺序
先重写描述。大多数"不激活"的问题，其实是描述问题，不是指令问题。