技能和说明书差在哪
说明书始终在。技能按任务加载：开 PR、做评审、跑发布检查。它有触发条件、步骤和禁区。
没有禁区的技能只是一段提示词。先写什么时候用、先读什么、不要碰什么。
若你一直把同一份清单贴进聊天，你已经有一个技能了。写下来一次。
技能文件夹放哪
官方文档描述过几种位置：用户级技能目录、仓库内的技能目录。具体文件夹名有过 .agents/skills、Codex 主目录下的 skills 等写法，请以当天文档为准。
团队共享的流程放进仓库。只有你自己用的放用户级。重名时，客户端通常不会让你同时选两个同名技能。
加完文件夹后重新加载客户端。找不到技能，多半是扫描路径而不是模型。
- 仓库技能：跟仓库走，同事能复用。
- 用户技能：跨仓库的个人习惯。
- 新技能不出现时，重启或重新加载客户端。
最小 SKILL.md
开头用简短 frontmatter 写名字和一句话描述。描述要像触发器：当用户要开 PR 时使用。
正文写有序步骤和禁区。需要外部系统时，在技能里声明依赖，而不是假设 MCP 已经神奇出现。
给技能起一个你能打出来的名字。好玩但记不住的名字等于不会被点名。
- 名称稳定、可点名。
- 步骤短，能勾选。
- 单独列出禁止事项。
一个最小的 PR 技能
触发：用户要开 PR。步骤：读 AGENTS.md、列出改动文件、写短摘要、不要推送。
禁区：不要改写历史、不要加格式化工具、不要提交密钥。
- 像用户请求的触发句。
- 短的有序步骤。
- 权重相当的禁区清单。
怎么调用
先点名。很多客户端支持用技能名显式调用。隐式匹配不稳时，不要先怪模型，先把描述写成触发器。
本站技能目录只展示元数据。有安装字段也只是起点，先确认仓库里还有 SKILL.md。
隐式匹配失败就点名。然后收紧触发句，让后面的匹配能成。
- 小任务上先点名一次。
- 看它是否真按步骤走。
- 忽略步骤就收紧描述和禁区。
和 MCP 一起用
技能说怎么做，MCP 提供手。没有 MCP 的技能仍可约束本机命令。
不要为了“看起来完整”给技能配一堆服务器。下一章只接任务需要的那一条。
技能可以只管本机：跑测试、写 PR、拒绝密钥。MCP 是选项。
- 先有能跑通的技能。
- 再加一条只读 MCP。
用保留语气检查技能是否加载
重载后，问它能看见哪些技能，或在小任务上点名。若有列表命令，以当天文档为准。
若名字永远不出现，先确认文件夹里有 SKILL.md，再改提示词。
- 加完文件夹后重载。
- 在小任务上点名。
技能上的错
一份其实是第二份说明书的技能会打架。把常驻禁区和按需步骤拆开。
不要发布一份假设五条 MCP 已经存在的技能。
- 在技能里复制说明书。
- 假设 MCP 已经接好。
技能清单
完成意味着你点名调用过一次，并且它按步骤走了。
- 稳定的名字。
- 触发、步骤、禁区。
- 在真实小任务上调用过一次。
下一步：接一条仓库外的工具
只有技能需要仓库里没有的系统时，才打开 MCP 章。
否则留在这里，等同一任务重复三次再写第二个技能。