Claude Skills 是什么：技能、脚本与插件组成的资料库
读 Claude Skills 源码：Codex 安装器如何改动文件
运行脚本前看懂发现、替换和复制三个关键步骤
读 Claude Skills 源码：Codex 安装器如何改动文件知识学习CN编辑简报更新 2026-10-04
你将学会
- 看发现逻辑
- 看复制边界
- 把转换脚本另算
开始前需要
- 可丢弃的测试项目
- 固定的仓库提交
- 一个支持的 Agent 客户端
把目录里的一个条目变成可测量的团队决策
先看结论
- 脚本会删除同名目标。
- `cp -rL` 会跟随镜像链接。
- 索引与目录可能不一致。
看发现逻辑
固定版本的 `codex-install.sh` 先检查 `.codex/skills` 镜像目录，可选读取 `skills-index.json`。`--list` 列候选项，`--skill` 把范围缩到一个包。
缺少索引会限制按分类安装，但全量路径还能遍历镜像条目。索引和文件系统如果不同步，这两个入口看到的内容可能不同。
看复制边界
`install_skill` 拒绝空名称和路径分隔符，检查源目录有 SKILL.md，再计算 Codex 目标路径。干跑在创建目录、删除和复制前就返回。
正式运行则创建目标根目录，删除同名目标，执行 `cp -rL` 跟随链接复制。代码没有在复制后校验文件哈希，所以可复现发布需另加核验。
把转换脚本另算
`convert.sh` 与 `install.sh` 是其他客户端的路径，不能从 Codex 脚本推断其行为。市场条目说明插件位置，也不是权限策略。
我们阅读了这些固定文件，未执行安装。如果你改了目标目录环境变量，运行含删除动作的脚本之前要确认解析出的绝对路径。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
阅读前提检查和索引分支。
- 2
跟踪一个名称从干跑到实际复制。
- 3
确认目标路径及复制后的哈希。
可复制示例
text
--skill 名称 -> 检查源 SKILL.md -> 计算目标
--dry-run -> 仅打印
正式运行 -> 删除同名目标 -> cp -rL常见问题
干跑会删掉旧技能吗？
不会；固定版本函数在创建、删除与复制之前返回。
安装器会校验复制后的哈希吗？
检查到的路径没有这一环，应在发布流程中补上。
资料来源
- Claude Skills / scripts/codex-install.sh来源核查 2026-10-04
- Claude Skills / INSTALLATION.md来源核查 2026-10-04
- Claude Skills / scripts/convert.sh来源核查 2026-10-04
- Claude Skills / scripts/install.sh来源核查 2026-10-04
- Claude Skills / .claude-plugin/marketplace.json来源核查 2026-10-04