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

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

决策

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

引擎	官方仓库	接入方式
Claude	anthropics/skills	Claude Code 插件机制（`claude plugin`），按路径加载已启用插件声明的技能（ADR-0013）
Codex	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，运行环境已具备）
官方仓库更新后，在后台"更新目录"即可看到并升级已安装技能（固定提交号，可追溯）