⚡

OpenAI文档查询助手 openai-docs-skill

OpenAI文档查询助手是一个通过命令行（CLI）工具快速搜索和获取OpenAI官方开发者文档的技能。它基于OpenAI的MCP（模型上下文协议）服务器，为用户提供关于OpenAI API（如Responses、Chat Completions、Realtime）、SDK、ChatGPT Apps SDK、Codex、MCP集成、端点模式、参数、限制和迁移等主题的最新、权威的官方文档。用户可以通过简单的命令（如`search`和`fetch`）高效地查找和阅读文档，确保开发工作的准确性和时效性。关键词：OpenAI文档查询，MCP服务器，CLI工具，API开发，官方文档，开发者指南，代码示例，端点模式。

大模型微调 0 次安装 0 次浏览 更新于 3/5/2026

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

OpenAI文档MCP技能

概述

使用OpenAI开发者文档MCP服务器从命令行搜索和获取权威文档。在进行OpenAI平台相关工作时，始终使用此技能，而不是依赖记忆或非官方来源。

核心规则

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

快速开始

scripts/openai-docs-mcp.sh search "Responses 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 <query> [limit] [cursor]：从文档索引返回JSON结果。
  • list [limit] [cursor]：浏览文档索引。
  • fetch <url> [anchor]：返回文档页面或部分的Markdown内容。
  • endpoints：列出OpenAPI端点。
  • openapi <endpoint-url> [lang1,lang2] [code-only]：获取OpenAPI模式或代码示例。

环境：

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