先说一个核心判断：要让 Codex 稳定执行“写测试用例”“校验接口文档”“生成 Git 提交信息”这类标准化重复工作，必须搞清楚 Skill 与 Plugin 的分工——它们既不是同义词，也不能互相替代。

Skill 是给 AI 参照的工作说明书，定义“怎么干”；Plugin 是封装好的能力安装包，解决“怎么交付”，内含 plugin.json、多个 Skill、MCP 等配置，支持一键安装与团队分发。

Skill 是什么：一份面向 AI 的操作指南与工作说明书

打开 Codex 工作区，点击左侧 Skills 标签，再点击 +New Skill。接着填写 Skill 名称（例如 git-commit-generator），选择触发方式（手动调用、自动匹配关键词或绑定快捷键）。

在编辑区编写 SKILL.md 文件，必须包含三块核心内容：【目标】——一句话说清这个 Skill 要达成的效果；【输入】——用户需提供的素材，比如 diff 输出、PR 描述、分支名；【步骤】——按顺序书写 AI 应执行的操作。例如：“先读 diff 中 modified/added 文件列表 → 过滤掉 .md 和 .test.js → 对每个核心文件提取函数名 → 按模块分组归纳改动点”。

这一步不能只写“请写个提交信息”——必须明确判断逻辑和过滤条件，否则 Codex 会把 .lock 文件、.gitignore 变更也塞进标题里，严重影响输出质量。

Plugin 是什么：一套打包好的可分发能力安装包

Plugin 并非代码，而是一个 ZIP 压缩包，里面至少包含：一个 plugin.json（声明元信息）、若干 Skill 文件、可选的 MCP Server 配置、图标与 README 文档。

安装方式有两种：

方法一：从 Marketplace 安装最新插件
点击 Plugins → Browse → 找到 codex-plugin-cc → Install → 等待 /reload-plugins 自动执行。

方法二：本地加载自定义插件
将打包好的 plugin.zip 放入 Codex 安装目录下的 plugins/ 文件夹 → 重启 Codex → 在 Plugins 页面点击 Enable。

【注意】 插件启用后，其所含的所有 Skill 会自动注册进系统，但不会覆盖已有同名 Skill——新插件里的同名 Skill 优先级更高。这一特性极易踩坑，务必留意。

关键区别：谁负责流程，谁负责交付

① Skill 是最小可复用单元，解决“怎么干”的问题；Plugin 是交付载体，解决“怎么给别人用”的问题。

② 你可以在本地反复修改一个 Skill 并实时测试效果；但 Plugin 必须重新打包、重新安装才能更新。

③ 一个 Plugin 可以包含多个 Skill、多个 MCP 工具、配套文档和图标资源；而一个 Skill 无法单独分发，必须依附于 Plugin 或本地工作区。

④ 当团队协作时，新人安装一个 Plugin 就能获得整套开发规范（含 commit 格式校验 Skill + API 文档生成 Skill + 测试覆盖率检查 Skill）；如果只共享 Skill 文件，对方还需手动逐个粘贴、配置触发条件、寻找配套脚本——效率差距极大。

⑤ Skill 可被多个 Plugin 引用；Plugin 一旦安装，其内部 Skill 就成为 Codex 全局可用能力的一部分。

总而言之，Skill 和 Plugin 是 Codex 扩展体系里两个互补的角色：前者定义任务执行逻辑，后者封装能力便于分发。理解它们的边界，才能让 AI 真正变成团队的稳定生产力工具，而非一个偶尔失常的高级玩具。