Codex Skill 安装使用教程

有没有对 AI 说过同一件事超过三次？

我数过，光是「帮我给这个模块写单元测试，格式用 Jest，覆盖主要分支，注释用中文」这句话，一周里说了六遍。Codex 每次都做对了，但每次都得从头解释一遍。

后来发现，这事有解。解法叫 Codex Skill——把重复指令写成文件，一次配置，永久调用。

相关教程推荐：

Codex 新手？先看 Codex App 完整使用指南

需要 ChatGPT Plus？请查看 ChatGPT Plus 一键充值教程

Codex Skill 是什么

一句话：把你常让 AI 干的事，写成一个文件，以后直接调用。

具体来说，一个 Codex Skill 就是一个文件夹，里面有一个 SKILL.md。写清楚名字、触发时机、具体要怎么干。

Codex 的加载方式也挺省心的——平时只读 Skill 的名字和描述，用到的时候才加载完整内容。不会一下把所有指令都塞进上下文，省 token，响应也快。

Codex Skill 的触发方式有两种：

显式调用：输入 $ 选技能，或者直接在对话里写 $skill-name
隐式匹配：根据你说的任务，Codex 自己判断要不要用某个 Skill

如何查找和安装 Codex Skill

Codex 内置 Skill

Codex 内置了不少官方 Skill，打开就能用。代码审查、测试生成、重构建议这些都有。

从官方仓库安装 Codex Skill

想找更多 Codex Skill，官方维护了一个仓库：

github.com/openai/skills

找到喜欢的文件夹，复制过来就行。

更省事的方式是直接用安装命令：

$skill-installer linear

支持按名字安装 Codex Skill，也能从其他 GitHub 仓库下载。这跟 Codex App 里的 Skills 管理是一套体系，CLI 和 App 端的 Skill 完全互通。

Codex Skill 存放路径配置

Codex 会自动扫描以下位置来加载 Skill：

范围	路径	用来干什么
仓库	项目根目录 `.agents/skills/`	团队共享，提交到 git 一起管
用户	`~/.agents/skills/`	个人通用，所有项目都能调
系统	`/etc/codex/skills`	机器级配置，管理员场景

个人用的话，把 Codex Skill 丢到 ~/.agents/skills/ 里最省事。所有项目通用，不用每个项目单独配。

团队项目里有固定工作流的，放仓库根目录的 .agents/skills/，提交到 git，团队所有人都能用同一套 Skill。

Codex Skill 调用方法

显式调用 Codex Skill

放好 Skill 之后，对话里直接用：

$unit-test 帮我给这个 AuthService 写测试

或者输入 $ 触发列表，选完再补描述。

CLI 里用 /skills 可以查看当前所有可用的 Codex Skill 列表。

禁用不需要的 Codex Skill

用腻了某个 Skill 又不想删？在 ~/.codex/config.toml 里关掉：

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

重启 Codex 生效。

Codex 用户推荐

ChatGPT Plus 充值开通

Codex 使用需要 ChatGPT Plus，支持支付宝/微信直接充值

ChatGPT 充值

自定义 Codex Skill 编写教程

找不到合适的现成 Skill？自己写也快。

使用 Skill Creator 快速创建

Codex 内置了一个 Skill 创建向导：

$skill-creator

它会问你这个 Skill 干什么、什么时候触发、要不要带脚本。回答完自动生成文件。

手动编写 SKILL.md

手动建一个 Codex Skill 也很简单：

mkdir my-skill && touch my-skill/SKILL.md

SKILL.md 格式如下：

---
name: my-skill
description: 什么时候用这个 Skill，什么时候不用。写具体点。
---

具体的指令步骤写在这里。

description 字段的正确写法

这个字段直接决定 Codex Skill 能不能被正确触发。Codex 的隐式匹配就靠 description 来判断要不要调用这个 Skill。

写太模糊，要么什么任务都触发，要么一次也不触发。建议明确写出：什么场景用、什么场景不用、输入输出是什么。

在 Cursor、TRAE 等 AI 编程工具中使用 Skill

这里有个很好玩的地方。

Codex Skill 的格式就是普通 Markdown 文件。任何能读文件的 AI 编程工具都能用，不需要任何特殊配置。

Cursor、TRAE、GitHub Copilot、Droid 都行。方法也简单，在提示词里直接 @ 文件路径：

请使用 @.agents/skills/unit-test/SKILL.md，帮我给这个模块补充测试

如果你需要用到哪个 Skill，只需要手动 @ 一下相应的 Skill 文件即可，比如：

请使用 @.claude/skills/artifacts-builder/SKILL.md ，创建一个 whiteboard 项目

Codex Skill 在 Cursor 中通过 @ 引用调用

也就是说只要你让 Agent 去读取相应的 SKILL.md 文件，就可以让 Agent 学会使用 Skill。

这个方法不仅适用于 Codex，也同样适用于 TRAE、Cursor、GitHub Copilot 这类 AI 编程工具。如果你在用 Claude Code，也可以用类似的方式加载 Skill。

哪些场景适合做成 Codex Skill

判断很简单：同一件事让 AI 做过三次以上，每次都在重复解释——值得写成 Codex Skill。

几个常见场景：

固定格式的文档或注释生成
项目专属的代码审查规范
统一的提交信息格式要求
反复用到的调试或测试流程

写一个 Codex Skill 花十分钟。之后每次调用省下来的时间，加起来早就回本了。

从下次不想再解释第二遍的时候开始。

常见问题

Codex Skill 和 Codex Plugin 有什么区别？

Skill 是一个 Markdown 文件，定义了 Codex 在特定场景下应该怎么做。Plugin 是更重量级的扩展机制，可以引入外部工具和 API。日常使用中，大部分重复性任务用 Skill 就够了。想了解 Plugin 可以参考 Codex Plugin 教程。

Codex Skill 安装后不生效怎么办？

检查三点：文件路径是否在 Codex 的扫描目录下（~/.agents/skills/ 或项目的 .agents/skills/）、文件名是否为 SKILL.md、description 是否写得足够具体。如果路径正确但仍无法加载，尝试重启 Codex。

自定义 Codex Skill 能在团队里共享吗？

可以。把 Skill 放在项目根目录的 .agents/skills/ 文件夹中，提交到 Git 仓库，团队所有成员拉取代码后就能直接使用。

Codex Skill 能在 Windows 上使用吗？

可以。Codex 已支持 Windows，Skill 的使用方式和 Mac/Linux 完全一致。详细的 Windows 安装流程可以参考 Codex Windows 安装教程。