# ADR-0016 每个引擎接入各自厂商的官方技能仓库

- 状态：Accepted · 日期：2026-10-23 · 补充 ADR-0013

## 决策
官方技能不交叉使用，每个引擎只用自己厂商的官方仓库，在后台"技能与插件"页面按引擎分页管理：

| 引擎 | 官方仓库 | 接入方式 |
|---|---|---|
| Claude | [anthropics/skills](https://github.com/anthropics/skills) | Claude Code 插件机制（`claude plugin`），按路径加载已启用插件声明的技能（ADR-0013） |
| Codex | [openai/skills](https://github.com/openai/skills) | 服务端获取仓库在某个提交上的快照（缓存在数据目录），把选中的技能复制到服务专用 `CODEX_HOME/skills/<name>` 并写标记文件（来源、提交、许可证）；Codex 自动加载 |

- 本地技能目录（自写技能，如 report-conventions）两个引擎共用：Claude 以插件方式加载，Codex 通过 `skills/extraRoots/set` 加入
- 按 Profile 选择技能：Claude 用 SDK 的 `skills` 列表；Codex 在每次对话的 config 中用 `skills.config` 按路径禁用未选中的技能
- Codex 系统技能 `skill-installer`、`skill-creator`、`plugin-creator` 始终禁用（会联网下载或写入 Codex 自身目录）
- 已安装技能的脚本与资源在 Codex 沙箱中只读可见

## 许可约束
- Codex 侧只允许安装**开源许可（Apache-2.0 / MIT）**的技能；专有许可、第三方条款（如 Figma 技能"governed by the Figma Developer Terms"）、无法识别的许可都拒绝安装
- 不使用 Codex 桌面版运行时中的插件：其中 spreadsheets、presentations 依赖 `@oai/artifact-tool`，该组件为专有许可且"仅限内部评估测试、禁止生产使用"；documents、pdf 插件虽为 MIT，但只能通过桌面版（code-server 中的扩展）获取，不作为服务依赖
- openai/skills 中的 Word（doc）技能已于 2026-05-01 被 OpenAI 移出公开仓库，Codex 处理 Word 使用自写技能 + python-docx

## 后果
- Codex 目前可用的官方文档技能为 pdf（Apache-2.0，依赖 reportlab / pdfplumber / pypdf / poppler，运行环境已具备）
- 官方仓库更新后，在后台"更新目录"即可看到并升级已安装技能（固定提交号，可追溯）