Codex Skills 技能教程：打造专属开发助手
2026-08-22 14:27:36阅读 1
AGENTS.md 是“规矩”，Skills 是“手艺”。如果说 AGENTS.md 告诉 Codex“不能干什么”，Skills 就是教它“怎么把一类活干漂亮”——把重复流程打包成技能，以后一句话就能触发。
Skill 是什么
官方定义（原文）：skill 为特定任务或工作流打包指令与配套资源。一个技能可以包含：
- 帮助 Codex 判断“什么时候该用”的名称与描述
- 定义处理流程和预期结果的工作流指令
- 模板、示例、schema 等配套资源
通俗理解：把“你每次做某件事的固定流程”写下来，Codex 遇到同类任务就照做。
怎么触发一个 Skill：记住这个区别
官方原文给了很实用的提醒：
- ChatGPT 用 @ 提及技能
- Codex 用 $ 提及技能
比如你在 Codex 里看到 $weekly-report，就是在调用那个技能。当然，Codex 也可以自动判断任务匹配哪个技能（靠技能里的描述），不一定非要手动触发。
什么时候值得做一个 Skill
官方建议：当好结果依赖一套可重复的方法时，skills 最有价值。典型例子：
- 准备每日/每周简报
- 评审文档
- 创建演示文稿
- 应用团队写作规范
- 每周从同一批工具收集信息
判断标准：这个流程你重复做过三次以上，就值得做成 Skill。
从零创建一个 Skill：官方给的流程
官方文档给了一条非常接地气的路径——别上来就写文件，先描述流程：
- 选一个聚焦任务（别贪多）
- 记录你通常提供的文件、链接、笔记，以及结果该长什么样
- 向 Codex 描述工作流：目标、步骤、预期格式、必须包含/避免的内容
- 用一句话让 Codex 生成：新建聊天，说 "Build me a skill..." 并附上你的描述
- 评审并试用：用真实请求测试；漏步骤或跑偏就继续调整
- 安装并复用：启用后 Codex 可以在相关请求中自动使用，你也可以显式选择
想手写技能文件（SKILL.md）的细节，可参考官方文档中关于构建技能的部分。
Skill vs AGENTS.md vs 插件
| Skill | AGENTS.md | 插件（Plugin） | |
|---|---|---|---|
| 内容 | 可复用流程/手艺 | 项目规矩 | 技能+连接器组合包 |
| 触发 | 相关任务时按需 | 每次会话注入 | 安装后可用 |
| 类比 | 操作手册 | 规章制度 | 工具箱 |
三者互补不冲突（官方原话："这些能力彼此互补，而不是互相替代"）。
常见问题
| 问题 | 解答 |
|---|---|
| 技能用不了？ | 检查技能是否启用、描述是否写清触发场景 |
| 技能和 AGENTS.md 都写规矩，重复吗？ | 一个管“怎么干活”一个管“什么能干”，各司其职 |
| 想分享给团队？ | 工作区设置允许时可以分享（官方原文） |
| 技能能带模板吗？ | 可以，配套资源是 Skill 的一部分 |
一句话总结
Skill 是把你的“独家手艺”传授给 Codex 的方式。 一次封装，永久复用，还能传给团队。
接下来读什么
- 技能与规矩的分工 → AGENTS.md 项目指令
- 接外部工具 → MCP 集成
← 上一篇：4.1 AGENTS.md 项目指令 | 下一篇：4.3 MCP 集成 → ↑ 返回 教程总目录
