上传前的准备
优先使用可复制文本的 PDF。扫描版、复杂双栏排版或带有大量页眉页脚的文件，可能需要先做 OCR 和版面清理。
- 确认你有权处理和使用该文件
- 检查文件不是加密 PDF
- 尽量保留目录和段落结构
- 当前单文件上限为 50MB
生成后先做三项检查
下载前先查看集合页。确认 Skill 名称没有大范围重复、描述能说明触发场景、步骤没有脱离原书的关键约束。
- 检查 Skill 数量与主题覆盖
- 抽查关键 Skill 的描述与步骤
- 确认来源书名和语言
- 不确定时先在隔离 Codex 环境试用
安全安装到 Codex
Book2Skill 安装脚本会把同名旧版本移入备份目录，再原子替换新 Skill。安装完成后重启 Codex 即可加载。
- 下载 ZIP
- 解压并阅读 README
- 运行 deploy-mac.sh
- 查看备份目录和安装结果
- 用一个真实任务验证触发效果
常见问题
扫描 PDF 可以转换吗？
需要先获得可靠 OCR 文本；识别质量会直接影响 Skill 的来源忠实度。
生成结果可以手动修改吗？
可以。下载包是普通目录与 Markdown 文件，建议在安装前先审阅并按自己的工作流调整。
准备把 PDF 变成 Codex Skills？
先用一个你熟悉的文件验证结果，再决定是否纳入长期工作流。
上传 PDF 开始转换