Codex Skills 怎么用？安装、启用、创建自己的技能
Skill（技能）可以把一件经常重复的工作流程打包起来：什么时候用、按什么步骤做、需要哪些脚本和资料。需要时 Codex 自动或手动调用，不用每次重新写一大段提示词。
先分清四个概念#
| 载体 | 用来做什么 | 作用范围 | 例子 |
|---|---|---|---|
| 当前提示词 | 说明这一次要做什么 | 这一次对话 | 「只改认证模块，修这个登录 Bug」 |
AGENTS.md | 记录一个仓库的长期规则 | 当前仓库 | 「统一用 npm test，不要改 dist/」 |
| Skill | 封装可重复的任务流程 | 个人、项目或插件 | 「每次审查仓库都按架构、测试、安全、发布风险输出」 |
| 插件（Plugin） | 把多个技能和其他扩展一起分发 | 个人、团队 | 审查技能 + 某个工具连接 + 图标 |
判断要不要做成 Skill：会反复出现、流程相对固定、还要配合脚本或资料，三条都满足就值得。只做一次的事直接写提示词；只对某个仓库长期有效的规则写进 AGENTS.md。
Skill 放在哪#
| 类型 | 常见位置 | 说明 |
|---|---|---|
| 个人 Skill | ~/.agents/skills/<名称>/SKILL.md | 所有项目通用 |
| 项目 Skill | <项目根目录>/.agents/skills/<名称>/SKILL.md | 随仓库一起管理，团队成员拉取即用 |
| 旧位置 | ~/.codex/skills/<名称>/SKILL.md | 为兼容保留，已经能用的不必急着搬 |
不同版本的默认目录可能不一样，以你当前客户端显示的技能列表为准。必须复制整个技能文件夹，不能只拿一个 SKILL.md，否则里面引用的脚本和资料会找不到。
怎么安装#
方式一：让 Codex 帮你装#
支持内置安装器的版本，直接在对话里说就行：
使用 $skill-installer，从这个 GitHub 目录安装 Skill：
https://github.com/owner/repo/tree/main/path/to/skill安装器会把目录复制到个人技能目录，并检查里面有没有 SKILL.md。
方式二：手动复制#
把整个技能文件夹放进上面的个人或项目目录，然后新开一轮任务，或在客户端里刷新技能列表。看不到时，依次检查：
- 文件名是不是严格的大写
SKILL.md。 - 文件开头的
---信息头是不是完整闭合。 - 技能有没有被界面或配置禁用。
- 重新打开任务或客户端后是否出现。
别把陌生仓库当成可信技能
Skill 会指挥 Codex 干活，还可能带脚本。安装前至少看一遍 SKILL.md、scripts/、联网地址和安装命令，先在测试仓库里跑。Skill 不是安全边界，不能替代沙箱和审批。
怎么调用#
- 显式调用：在输入框里点名，例如
使用 $repo-audit 审查当前仓库，只读，不要改文件。不同客户端的符号可能是$或@，以输入框弹出的列表为准。第一次测试用这种方式最容易确认。 - 自动触发：Codex 先只看到每个技能的名称和描述，觉得匹配才加载正文。所以能不能自动触发，关键在
description写得好不好。
手写一个最小 Skill#
下面是一个只读审查仓库的例子，放在 ~/.agents/skills/repo-audit/SKILL.md：
---
name: repo-audit
description: Perform a read-only audit of a code repository and report architecture, testing, security and release risks. Use when the user asks to audit or review a repository without modifying files.
---
# Repository Audit
## Workflow
1. Read the applicable AGENTS.md files.
2. Inspect the repository structure and dependency manifests.
3. Review source code, tests, configuration and CI files.
4. Do not modify files, install packages, commit, push or deploy.
5. Verify every finding against a concrete file or execution path.
## Output
- List findings first, ordered by severity, with the affected file.
- Separate confirmed defects from unverified risks.
- State which checks were not run and why.几个写法要点：
- 名称用小写字母、数字和连字符，文件夹名和
name保持一致。 description要同时写清「做什么」和「什么时候用」，因为 Codex 在选中技能之前看不到正文。只写「你是个专家」几乎无法触发。- 正文写步骤，不要大段讲概念；明确写出「不要修改、不要提交、不要部署」这类边界。
- 脚本放
scripts/，长资料放references/，模板和素材放assets/。没有就不要建空目录。
不触发、乱触发怎么办#
| 现象 | 处理办法 |
|---|---|
| 列表里找不到 | 检查目录层级、文件名大小写、信息头格式，重开任务 |
| 点名了仍不加载 | 名称拼写与信息头不一致，或存在同名技能；直接在列表里选中 |
| 脚本找不到 | 只复制了 SKILL.md；技能内引用要用相对路径（如 scripts/check.py），不要写死作者电脑的路径 |
| 总是误触发 | 把 description 写窄，加上排除条件；或关闭隐式调用，只允许手动点名 |
| 触发了但结果不稳定 | 把关键步骤写具体，长资料拆到 references/，别把整份文档塞进 SKILL.md |
常见问题#
Skill 和插件是一回事吗？#
不是。Skill 是一套任务说明和资源；插件是分发容器，可以装一个或多个 Skill，还可以带别的扩展。个人自用一个技能文件夹就够了。
创建 Skill 必须会编程吗？#
不需要。最小的 Skill 只有一个 Markdown 文件。只有流程需要稳定自动化时才加脚本。
Skill 能绕过权限吗？#
不能。它只提供流程，沙箱、审批、文件权限和账号权限照常生效。