🚀 快速安装

复制以下命令并运行，立即安装此 Skill：

npx @anthropic-ai/skills install am-will/codex-skills/openai-docs-skill

💡 提示：需要 Node.js 和 NPM

OpenAI 文档 MCP 技能

概述

在 shell 中使用 OpenAI 开发者文档 MCP 服务器来搜索和获取权威文档。对于所有 OpenAI 平台相关工作，请始终使用此技能，而不是依赖记忆或非官方来源。

核心规则

  • 对于涉及 OpenAI API/SDK/应用/Codex 的问题，或在需要精确、最新文档时，务必使用此技能。
  • 通过 scripts/openai-docs-mcp.sh 中的 CLI 包装器查询 MCP 服务器（不要依赖 Codex MCP 工具）。
  • 使用 search 或 list 找到最佳文档页面，然后 fetch 该页面（或锚点）以获取精确文本。
  • 在回复中提供您所使用的文档 URL，以便来源清晰。

快速开始

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

工作流程

  1. 发现：使用聚焦的查询进行 search。如果不确定，使用 list 浏览。
  2. 读取：fetch 最相关的 URL（可选地添加锚点）。
  3. 应用：总结和/或引用相关部分；包含 URL。

脚本参考

CLI 包装器位于 scripts/openai-docs-mcp.sh，它使用 curl 和 jq 与 https://developers.openai.com/mcp 交互。

子命令：

  • init：初始化并检查服务器能力。
  • tools：列出 MCP 服务器上的可用工具。
  • search <查询词> [限制条数] [游标]：从文档索引返回 JSON 匹配结果。
  • list [限制条数] [游标]：浏览文档索引。
  • fetch <URL> [锚点]：返回文档页面或章节的 Markdown 内容。
  • endpoints：列出 OpenAPI 端点。
  • openapi <端点URL> [语言1,语言2] [仅代码]：获取 OpenAPI 模式或代码示例。

环境变量：

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

📄 原始文档

完整文档（英文）：

https://skills.sh/am-will/codex-skills/openai-docs-skill

💡 提示：点击上方链接查看 skills.sh 原始英文文档，方便对照翻译。

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。