本期「新星首发」换了一层货架蹲守。星榜上撬棍与视频件挤破头的时候，真正先一步落到从业者手里的新件，往往走的是另一条路：多宿主分发仓直接装进本机技能目录，星数为零，使用已经开始。本期主角就是这样一个在册件——openai-docs，一份让 Claude 优先查 OpenAI 官方开发者文档的桥接件。本文全部引文出自该件 SKILL.md 原文（本机技能目录在册版本），逐段拆它的路由设计、自装协议与跨宿主指纹，并把它放回「文档接地」赛道，与此前拆过的 chub、3gpp-5g-specs 同族对账。
口径：功能 25%、设计 25%、实战 20%、上手 15%、活跃 15%；★☆ 为半星。openai-docs 为本期一手通读评分（SKILL.md 全文 + 注册描述，未实际跑通安装链路，实战分据此保守）；对照两行引自本刊存档评分，本期不重评。
| 件 | 功能 | 设计 | 实战 | 上手 | 活跃 | 终审 |
|---|---|---|---|---|---|---|
| openai-docs（本册一手） | ★★★☆ | ★★★★ | ★★★☆ | ★★★★ | ★★☆ | 3.55 |
| context-hub-get-api-docs（chub，存档 07-12） | ★★★★ | ★★★★★ | ★★★ | ★★★★ | ★★★★ | 3.95 |
| 3gpp-5g-specs（存档 09-28） | ★★★★★ | ★★★★ | ★★★★ | ★★★ | ★★★ | 3.95 |
先看门牌。这个件的自我介绍只有一句话：「Provide authoritative, current guidance from OpenAI developer docs using the developers.openai.com MCP server」，紧接着是一条排他令：「Always prioritize the developer docs MCP tools over web.run」。两句连读，定位就清楚了：它自己不生产任何知识，它是路由器——把「OpenAI 相关问题」这股流量，强制导流到官方文档服务上去。值得逐字读的是那条负向声明：它禁止的不只是「凭记忆猜」，而是点名了替代通道 web.run。写件的人把「何时别找我」写进了第一段，这种写法在生成件里少见，在接地件里却是命根子——接地件的全部价值就在「不许绕过」四个字上。
第一段拆完看工具层。 Quick start 给了三枚 MCP 工具：search_openai_docs 检索、fetch_openai_doc 取节、list_openai_docs 浏览。设计上最讲究的是第三枚的括号注：「only when you need to browse or discover pages without a clear query」——浏览工具被显式降级为兜底。三件套的排列顺序就是优先级链：先检索、再取节、最后才许翻目录。对照很多文档件的通病（一股脑把全部工具平铺给模型），这里把「模型最省事的路径」和「最正确的路径」用排列顺序钉在了一起，是提示词工程里成本最低的一招。
第二段是产品快照，其实是触发词表。 SKILL.md 列了七条产品线：Apps SDK、Responses API、Chat Completions API、Codex、gpt-oss、Realtime API、Agents SDK，每条一行白描。表面是科普，实际是给路由判断准备的名词表——用户嘴里蹦出「Responses API 状态怎么存」「gpt-oss 是什么协议」，这些词都能在快照区命中。这张表还有副产物：它给文件标了日期。gpt-oss 出现在列，说明这份文件成文于开放权重模型发布之后；而全篇没有任何模型版本号的维护机制，意味着它会随着 OpenAI 产品线演进悄悄过时。这一点后面对照 chub 时会再算账。
第三段是全件最大胆也最值得警惕的设计：缺服务器自装协议。 「If MCP server is missing」一节写了一个四级递进：检测失败后，第一步「Run the install command yourself」——让 Agent 自己执行 codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp；第二步，若权限沙箱拦下，「immediately retry the same command with escalated permissions」，附带一句正当性说明；第三步才轮到「ask the user to run it」；第四步让用户重启宿主，再重试。把「自装、提权重试、最后才打扰人」写成硬序，等于给 Agent 发了一张先斩后奏的施工证。本刊拆官方配置件时总结过「顾问不开药方之外的手」的克制路线，这个件走了相反的极端：装机员自己开机箱。工程上它换来「装完即用」的顺滑，代价是把一条第三方分发件的指令，变成了宿主里自动执行的供应链入口——装它的仓库越杂，这一段越该被读一遍再启用。
第四段是质量规则，管的是嘴。 「Treat OpenAI docs as the source of truth」「Keep quotes short and within policy limits; prefer paraphrase with citations」「If multiple pages differ, call out the difference and cite both」——三条连起来是一份引用纪律：不许 speculate、少引多述、文档打架时双引并标注。多数文档件的输出风险不是查不到，是查到之后把两个版本的说法搅在一起说，这里恰好卡住了那个环节。收尾的 Tooling notes 再补一道闸：退回网页搜索时「restrict to official OpenAI domains」——兜底通道也划了围栏。
通读全文，有两处口音不属于 Claude。其一，被禁用的替代通道叫 web.run——这是 Codex 宿主的工具名；其二，自装协议第四步写的是「Ask the user to restart Codex」，重启的宿主点名 Codex，而这份文件此刻躺在 Claude 的技能目录里。两处指纹合起来是一段清晰的迁徙史：这个件生在 Codex 的技能体系里，被多宿主分发改装后搬进了 Claude 的货架，搬家公司改了门牌，没改口音。本刊十月一日清点那座代工厂仓时记过一笔：三十一件房客每件都配着一份面向其他宿主的登记文件，「多宿主化已经深到对手的件都躺在同一层货架上」。openai-docs 是这句判词最好的注脚——连「对家的说明书」都是同一套布局重新封装后上架的。给写件人的启示正反各一条：正着学，一套 SKILL.md 跨宿主分发在今天已经是成熟路线；反着记，跨宿主移植后记得把宿主专名清干净，否则用户读到「请重启 Codex」时，装的是哪家的件都会让人犯嘀咕。
把镜头拉远，「让 Agent 用上最新文档」这个需求，货架上已经沉淀出三条路线。openai-docs 走的是厂商桥接线：单厂商、绑官方 MCP、政策优先、零本地内容。chub（context-hub-get-api-docs，Andrew Ng 的 andrewyng/context-hub 一线）走的是社区市场线：CLI 检索多厂商文档，最特别的是它给文档本身装了反馈回路——chub annotate 把踩坑记成局部笔记，chub feedback 让 Agent 给文档打分投票，过时会被显式标出。第三条是镜像线，本刊此前拆 cloudflare-deploy 时见过：把文档整卷搬进 references/ 目录，离线可用，代价是新鲜度封顶在打包那天。三条线各治一种病：桥接线治权威性，市场线治过时，镜像线治断网。openai-docs 的短板因此清楚——它对「文档会过时」这件事没有任何本地机制，全部赌在「实时拉官方」上；一旦 MCP 服务不可用，它的质量规则就只剩网页兜底的域名围栏在撑。
flowchart TD
Q["用户提出厂商相关问题"] --> A["优先走官方文档 MCP 三件套"]
A --> B{"服务可用且有结果？"}
B -->|可用| C["search 定位页面"]
C --> D["fetch 取节并带 anchor"]
D --> E["少引多述并标注出处"]
B -->|服务缺失| F["Agent 自行执行安装命令"]
F --> G{"安装成功？"}
G -->|成功| H["请用户重启宿主后重试"]
H --> A
G -->|失败| I["请用户手动安装"]
I --> A
B -->|仍无结果| J["退回站内限定搜索"]
J --> K["仅引官方域名作答"]
K --> E
# 文档 MCP 服务本体（SKILL.md 内置的自装命令）
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
# 在多宿主技能市场检索该件的现成分发
npx skills find openai-docs
# 同族对照件：社区文档市场路线
npx skills find context-hub
触发用法上，这个件吃行话不吃症状：「以官方文档为准，查 Responses API 里工具调用的参数结构」「gpt-oss-20b 什么许可证」这类带产品名词的问句会直接命中快照区；而「我想做个 AI 应用」这种宽问句不归它管，先交给别的件定产品线，再回来查文档。务实提醒一条：启用前先确认自装协议你接不接受——不接受的话，把「If MCP server is missing」一节手动删掉，剩下的路由和质量规则照常工作。
[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。