浏览 AI 知识库
Codex Skill 怎么安装：选择用户级、项目级或团队分发
Codex Skill 放在用户级、项目级还是团队分发位置，决定了谁会触发它、版本怎样同步。安装前先选作用域，并记录依赖与验证结果。
按实际操作顺序推进
每完成一段就检查当前输出，确认结果符合预期后再继续。
自己电脑能用的 Skill，为什么同事拉下仓库后完全看不到
团队 Skill 被放到某位成员的用户目录，其他人拉仓库后完全看不到；另一个个人 Skill 被提交到项目，导致所有任务都可能触发。
- 作用域与受众一致
- 个人路径和秘密未共享
- 安装后正反例均验证
动手前，把材料和不能改的部分定下来
| 需要确认 | 本例内容 |
|---|---|
| 现有材料 | 一个仅本人使用的写作 Skill，一个项目专用测试 Skill，一个需团队统一分发的发布 Skill。 |
| 不能越过的边界 | 作用域和目录以当前 Codex 文档为准；团队文件不含个人路径与秘密；安装后验证正例和非目标项目。 |
| 要交付的结果 | 安装记录与作用域说明 |
Codex Skill 安装，从“用户级”开始做
用户级
只影响个人环境，适合通用工作流和个人凭证引用；仍要避免在所有项目误触发。
项目级
与仓库任务、规则和脚本紧密相关，便于版本化；不要提交个人路径、密钥和本机专用依赖。
团队分发
需要固定版本、安装清单、兼容性、更新和回滚，不能只发一个文件夹截图。
依赖位置
脚本、运行时、模板和工具的安装方式与作用域一致，使用环境变量或相对路径。
反向验证
在目标项目应发现，在无关项目不应意外触发；换一台干净环境按说明安装。
同一个 Skill，安装作用域取决于谁需要复用和谁负责更新
| 需求 | 选择 | 理由 | 不能带入 |
|---|---|---|---|
| 个人在多个仓库统一整理周报 | 用户级 | 只有本人使用，流程跨项目复用 | 公司 Token、项目专用绝对路径 |
| 某仓库生成固定格式发布说明 | 项目级 | 规则、脚本和模板要跟随仓库版本 | 个人账号、机器专用依赖 |
| 设计团队统一检查图片交付 | 团队分发 | 多人复用，需要版本、兼容和回滚 | 只在作者电脑存在的字体或命令 |
具体目录、优先级和发现规则可能随客户端变化，执行安装前必须核对当前官方文档。
文件夹能复制，不等于团队能稳定运行
| 字段 | 示例记录 | 验收方式 |
|---|---|---|
| 版本 | [email protected] | Skill 文件和变更记录一致 |
| 运行要求 | Node 22；无需全局安装；读取 images/，写入 reports/ | 干净环境按说明安装 |
| 权限 | 本地读写，不联网，不读取凭证 | 脚本审计与越界测试 |
| 正例 | 检查 20 张商品图的尺寸、色彩空间和命名 | 生成逐文件报告 |
| 反例 | 用户只问图片创意时不触发 | 测试原话不调用 Skill |
| 回滚 | 恢复 1.2.2，并删除 1.3.0 缓存 | 另一位成员独立完成 |
完成后的安装记录与作用域说明
安装记录把个人写作放用户级，测试 Skill 放项目级，发布 Skill 通过团队仓库版本化分发。每个目录、版本、依赖和触发样例都有记录；非目标项目不触发项目 Skill。
为什么“文件位置正确，Skill 仍无法使用”还不能交付
文件位置正确，Skill 仍无法使用
- 原因
- 依赖、权限或重启/刷新要求未满足
- 怎么改
- 按当前客户端发现机制检查，并运行最小正例而不是只看文件存在