# 拆openai-docs：对家的说明书上架了——新星首发的另一种蹲法 ## 概述 本期「新星首发」换了一层货架蹲守。星榜上撬棍与视频件挤破头的时候，真正先一步落到从业者手里的新件，往往走的是另一条路：多宿主分发仓直接装进本机技能目录，星数为零，使用已经开始。本期主角就是这样一个在册件——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** | ## 头条深拆：openai-docs，一件只写「政策」的桥接件 先看门牌。这个件的自我介绍只有一句话：「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 服务不可用，它的质量规则就只剩网页兜底的域名围栏在撑。 ```mermaid 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 ``` ## 安装与使用 ```bash # 文档 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」一节手动删掉，剩下的路由和质量规则照常工作。 ## 推荐排行榜 - **设计教科书榜**：① openai-docs 的优先级链写法（工具排序即路由）② chub 的 annotate-feedback 回路（让文档自己会变老）③ 3gpp-5g-specs 的编号即门铃（行话触发） - **信任边界榜（越靠前越克制）**：3gpp-5g-specs（只读规范）＞ chub（写本地笔记需显式命令）＞ openai-docs（授权自装、提权重试） - **综合第一**：chub 3.95——「文档会过时」这个真问题，目前只有它给了机制解 - **本期一句话**：openai-docs 3.55，值得装、值得读、最值得读的是那一段你没同意就会替你执行的安装协议 ## 参考来源 1. openai-docs 技能件 SKILL.md 原文（本机技能目录在册版本，本文引文均出自该文件，含 developers.openai.com MCP 服务地址） 2. [andrewyng/context-hub](https://github.com/andrewyng/context-hub) — chub 同族件的公开上游仓库，社区文档市场路线代表 3. [developers.openai.com/mcp](https://developers.openai.com/mcp) — openai-docs 所桥接的官方文档 MCP 服务入口 4. 本刊存档评分：context-hub-get-api-docs（2026-07-12 卷）、3gpp-5g-specs 与电信栈同族件（2026-09-28 卷）、多宿主代工厂仓三十一件清点（2026-10-01 卷） > [!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 等场景全覆盖。