openai-docs-skill

原文：🇺🇸 英文

已翻译

包含 1 个脚本

通过OpenAI Docs MCP服务器，使用CLI（curl/jq）查询OpenAI开发者文档。当任务涉及OpenAI API（Responses、Chat Completions、Realtime等）、OpenAI SDK、ChatGPT Apps SDK、Codex、MCP集成、端点模式、参数、限制或迁移，且你需要最新的官方指导时，请使用此工具。

11.9k次下载

来源am-will/codex-skills

添加于2026-02-04

NPX安装

npx skill4agent add am-will/codex-skills openai-docs-skill

SKILL.md 内容（中文）

查看翻译对照 →

OpenAI Docs MCP Skill

概述

通过shell使用OpenAI开发者文档MCP服务器来搜索和获取权威文档。在进行OpenAI平台相关工作时，请务必使用此工具，而非依赖记忆或非官方来源。

核心规则

当你有OpenAI API/SDK/Apps/Codex相关问题，或需要精准、最新的文档时，务必使用此工具。
通过
```
scripts/openai-docs-mcp.sh
```
中的CLI封装程序查询MCP服务器（不要依赖Codex MCP工具）。
使用
```
search
```
或
```
list
```
找到最佳文档页面，然后使用
```
fetch
```
获取该页面（或锚点）的准确文本。
在你的回复中附上所使用的文档URL，以便明确来源。

快速开始

bash

scripts/openai-docs-mcp.sh search "Responses API" 5
scripts/openai-docs-mcp.sh fetch https://platform.openai.com/docs/guides/migrate-to-responses

工作流程

发现：使用聚焦的查询词执行
```
search
```
。若不确定，使用
```
list
```
浏览。
读取：获取最相关的URL（可选择性添加锚点）并执行
```
fetch
```
。
应用：总结和/或引用相关章节；附上URL。

脚本参考

CLI封装程序位于

scripts/openai-docs-mcp.sh

，通过

curl

+

jq

调用

https://developers.openai.com/mcp

。

子命令：

```
init
```
：初始化并检查服务器功能。
```
tools
```
：列出MCP服务器上可用的工具。
```
search <query> [limit] [cursor]
```
：从文档索引返回JSON搜索结果。
```
list [limit] [cursor]
```
：浏览文档索引。
```
fetch <url> [anchor]
```
：返回文档页面或章节的markdown内容。
```
endpoints
```
：列出OpenAPI端点。

openapi <endpoint-url> [lang1,lang2] [code-only]

：获取OpenAPI模式或代码示例。

环境变量：

```
MCP_URL
```
：覆盖默认的MCP端点。