每个特工如何选择技能
每个代理首先读取技能名称和描述的列表，只有在选择一个技能后才加载技能的完整说明。该列表来自每个的前面的内容 SKILL.md （许多人搜索的文件为 Skills.md），并且它有一个大小预算：
| 代理 | 先读 | 当空间耗尽时 |
|---|---|---|
| Claude Code | 名称和描述，加上 when_to_use 如果设置；每个最多 1,536 个字符 | 该列表大约占据上下文窗口的 1%；最不常用的描述首先被删除 |
| Codex | 名称、描述和文件路径 | 该列表大约占据上下文窗口的 2%；首先缩短描述 |
| Cursor | 名称和描述 | 没有记录 |
安装了很多技能后，在代理权衡之前可以修剪或删除冗长或模糊的描述。这就是为什么第一句话最重要。
编写被选中的技能描述
按照队友要求工作的方式编写描述，并将主要用途放在第一句话中。
代理会将您的请求与这些词进行匹配，因此请使用人们实际输入的内容，例如“登陆页面”、“启动页面”或“推介材料”。首先命名输出，然后说明何时使用它。
被选中
它是什么以及什么时候
- “构建一个包含英雄、功能网格和定价切换的产品启动页面。当需要登陆或启动页面时使用。”
迷路了
通用
- “帮助建立网站。”
- 它与其他所有网络技能竞争，并且一旦缩短，几乎什么也不说。
如何测试是否触发
按此顺序进行测试。第一步排除了安装问题，因此在指向描述之后出现的任何失败。
- 1直呼其名。如果失败，则是安装问题；看到 故障排除.
- 2开始一个新的会话，这样之前的通话就不在上下文中，并用简单的语言询问，不带名字。
- 3询问代理使用了哪种技能，然后检查是否有只有该技能才会遵循的指令。
当错误的技能运行时
这通常意味着两个描述重叠，或者相同的技能安装了两次。
- 叫出你想要的人的名字。点名总是会获胜。
- 按输入、受众或输出缩小重叠描述，因此每个技能都有明确的工作。
- 两个地方同名：Claude Code 更喜欢 Enterprise，然后是 Personal，然后是 Project。Codex可能会列出两者。保留一份副本。
常见问题
为什么我的Claude技能没有触发？
先叫它名字。如果失败，则该技能不会安装在代理查看的位置；如果只有普通请求失败，请使用您实际输入的单词重写描述。
Claude如何决定使用哪个技能？
它会读取每项技能的名称和描述，然后加载最符合您请求的技能。打字 /skill-name 跳过该匹配并运行您命名的技能。
技能描述应该说什么？
该技能的作用是什么以及何时使用它，主要用途在第一句话中。使用人们实际输入的单词，例如“登陆页面”或“宣传材料”，因为描述可能会被缩短。
该文件名为 SKILL.md 还是 Skills.md？
It’s SKILL.md，每个技能文件夹中都有一个。它的正面内容包含特工在选择技能时阅读的名称和描述。
来源
本指南有帮助吗？