原生支持已有官方正文依据:Codex CLI 与 IDE 扩展可发现并调用独立 Agent Skills。官方列出的目录包括仓库 .agents/skills、用户 $HOME/.agents/skills、管理员 /etc/codex/skills 和系统内置技能;文档说明技能可显式或按描述隐式调用。MCP 是可能随技能或插件声明的外部工具依赖,不等同 Skill。操作系统最低版本门槛、CLI/IDE具体版本要求以及技能列表的精确界面因版本而异,本次已读正文未给出完整矩阵。本站具体条目的下载包、作者、许可证及脚本未逐项核验,须按条目和上游实际材料检查。未安装、未登录、未运行。
Préparation
- 安装并启动 Codex CLI 或 OpenAI Codex IDE 扩展;首次使用需按官方流程登录。
- 准备一个工作项目目录;按项目共享或个人使用选择仓库级或用户级技能位置。
- 从 Skills-SI 获取技能包前核对原作者、许可、来源和完整内容;不运行未审阅脚本,不在技能文件中填写密码、密钥或真实客户资料。
- 适用版本门槛及不同操作系统支持范围在本次读取的技能文档中未明确说明;CLI 快速入门说明其独立安装器适用于 macOS 与 Linux。
Installation et usage
- 01
准备 Codex 与项目目录
在目标项目中启动 Codex CLI,或在已安装并启用 Codex 的 IDE 项目中打开会话。CLI 首次启动依官方提示登录。保留 Git 检查点,避免练习直接改动真实项目。技能文档确认 CLI 和 IDE 扩展均支持独立 Skills;具体最低版本未注明。
当前项目目录(Codex 扫描当前工作目录至仓库根目录)codexSources et preuves当前项目目录(Codex 扫描当前工作目录至仓库根目录)Vérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 02
从本站安全取得技能包
在 Skills-SI 对应技能条目使用本站提供的下载入口取得包。下载前确认条目注明的原作者和许可证,并对照上游来源;信息不全或来源无法核对时先停止。下载位置随浏览器和用户设置而异,勿将不明镜像包当作官方包。
Sources et preuvesSKILL.md + resourcesVérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 03
检查并解压完整目录
解压后检查技能文件夹中有 SKILL.md,且文件头含 name 与 description。保留随包提供的 references、assets、scripts、agents 等目录及其他文件,不要只复制 SKILL.md。逐项审阅脚本、依赖说明和许可证;在确认前不要执行脚本。
解压所得技能目录(应包含 SKILL.md 及原包配套资源)Sources et preuves解压所得技能目录(应包含 SKILL.md 及原包配套资源)Vérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 04
放入 Codex 原生扫描目录
项目共享技能放入项目内 .agents/skills/<技能目录>/;个人跨项目使用放入 $HOME/.agents/skills/<技能目录>/。保留技能目录整体。Codex 官方文档也列出管理员位置 /etc/codex/skills;不熟悉系统级配置时勿改它。Codex 支持扫描符号链接目录。
项目级:$CWD/.agents/skills/<技能目录>/;个人级:$HOME/.agents/skills/<技能目录>/Sources et preuves项目级:$CWD/.agents/skills/<技能目录>/;个人级:$HOME/.agents/skills/<技能目录>/Vérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 05
调用并完成首次练习
在 CLI 或 IDE 扩展中用 /skills 查看技能,或在提示中以 $技能名 显式提及;也可提交符合技能 description 的任务供 Codex 自动匹配。首次练习使用虚构会议记录,请技能整理议题、决定、负责人和行动项;只用合成姓名与日期。
已安装技能目录中的 SKILL.md/skills;在提示中使用 $技能名Sources et preuves已安装技能目录中的 SKILL.mdVérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 06
验证发现、调用与输出
确认目标技能出现在 /skills 结果中,再显式点名运行首次练习;检查 Codex 是否依技能说明使用了所需资源,且输出符合预期。检查结果时核对事实、责任人与日期,不把自动匹配视为已成功调用。若刚复制或更新后未出现,重启 Codex 再查。
技能目录及其 SKILL.md、配套资源/skills;$技能名Sources et preuves技能目录及其 SKILL.md、配套资源Vérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 07
停用或卸载
可在 ~/.codex/config.toml 添加官方支持的 [[skills.config]] 项,以该技能 SKILL.md 的实际路径设置 enabled = false,然后重启 Codex。若要卸载,可从原安装位置移除该完整技能文件夹。官方已读文档未提供通用卸载命令;不要删除整个位于共享目录的其他技能。
~/.codex/config.toml;项目级或个人级技能目录Sources et preuves~/.codex/config.toml;项目级或个人级技能目录Vérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle.
Exercice et validation
用完全虚构的会议记录,请技能提取议题、决定、负责人和行动项;核对输出是否只引用输入中出现的信息。
- 在 CLI 或 IDE 扩展中查看 /skills,确认技能可发现;若刚安装后未出现,重启 Codex 后重查。
- 显式使用 $技能名 执行虚构会议练习,核对输出是否遵循 SKILL.md 的格式与约束。
- 检查依赖资源是否随完整目录保留;任何脚本或外部工具仅在已审阅且满足其自身前置条件后另行验证。
- 练习结束后检查项目变更,撤销非预期编辑;技能本身是否实际自动触发不能只凭最终答案推断。
Désactiver et désinstaller
- 需要暂时停用时,在 ~/.codex/config.toml 为技能的 SKILL.md 实际路径添加 [[skills.config]] 项并设 enabled = false;按官方说明重启 Codex。
- 彻底移除时,从安装时选用的项目级 .agents/skills 或个人级 $HOME/.agents/skills 位置删除该技能的完整目录。避免误删共享目录中的其他技能。
- 如果是经内置安装器取得的技能,本次读取的官方页面未说明专用卸载命令;不要猜测命令,按官方确认的实际存放位置核对后再移除。
Dépannage
技能目录已复制,但 /skills 中没有显示。
检查是否放在官方列出的扫描目录中,并确认目录内有包含 name、description 的 SKILL.md;重启 Codex 后再检查。
Codex 没有自动选择预期技能。
确认 description 清楚描述任务范围;先在提示中用 $技能名显式调用,以排除自动匹配不确定性。
安装多个技能后有技能未出现在初始列表。
官方说明技能很多时可能因初始列表上下文预算而缩短描述、隐藏部分项目并显示警告;直接使用 /skills 检查,并显式点名测试。
更新配置后技能仍可用,或停用未生效。
核对 ~/.codex/config.toml 中 path 是否指向该技能实际 SKILL.md,enabled 是否为 false;保存后重启 Codex。
技能要求运行脚本或调用外部工具,但练习无法完成。
先查看技能完整目录、许可和依赖说明,分别确认脚本依赖及所需工具已具备;不关闭安全防护,不执行未经审阅的代码。MCP 连接仅是可选工具依赖,不代表技能本身。
Sources et preuves
- https://developers.openai.com/codex/skills
官方 Codex Skills 正文:CLI 与 IDE 扩展原生支持;技能目录结构、仓库/用户/管理员位置、显式和隐式调用、重启、停用配置及 MCP 作为可选依赖。
- https://developers.openai.com/codex/cli
官方 CLI 正文:CLI 快速入门、首次登录、从项目目录运行;独立安装器列明 macOS 与 Linux;CLI 支持使用 Skills 和插件。
- https://developers.openai.com/codex/ide
官方 IDE 正文:Codex IDE 扩展及兼容编辑器的快速入门和使用场景;CLI/IDE使用技能细节以官方 Skills 文档为准。