OpenAI 官方文档助手
为 OpenAI 产品、API、Codex 与模型迁移问题提供基于官方资料的当前指导。
技能明确限定使用 OpenAI 官方文档 MCP，并将网页回退限制到官方域名；API 密钥门控、只读检索与外部动作边界有所说明。扣分在于未完整说明 MCP 数据流、凭据敏感信息处理、用户确认、回滚机制及网络依赖风险。
文档包含清晰的路由规则、失败回退、缓存校验、超时和错误处理说明，脚本实现也有哈希验证与原子写入。静态审查无法执行关键路径，且 MCP 工具可用性、Windows/代理环境和远程响应兼容性未由测试证明，因此不超过静态上限并扣分。
目标用户和主要场景较清楚，覆盖 OpenAI 文档、Codex、自身模型选择和迁移指导；也声明了部分非适用边界。扣分在于触发条件较复杂，中文输出支持未明确，核心功能依赖 developers.openai.com MCP/官方网络，可能受中国大陆网络可达性影响。
目录结构、工具依赖、引用材料、回退策略和 Apache-2.0 许可清楚，渐进披露较完整。扣分在于缺少独立版本号、变更日志、维护责任人和明确更新流程；本地引用内容还明确承认可能漂移。
对需要当前 OpenAI 文档、Codex 自知识和模型迁移的任务，路由和输出指导具有直接价值，且包含模型选择、兼容性和验证清单。静态材料没有代表性输出或运行证据，远程工具不可用时仍可能需要人工处理，因此按静态上限评为核心任务可完成但证据有限。
脚本提供 HTTP 哈希校验、缓存状态和可审计的本地手册路径，引用 URL 与工具名称也较具体。扣分在于没有提交覆盖关键路径的测试、CI 执行证据或第三方复核；多数能力依赖运行时 MCP/网络，静态材料只能支持有限可验证性。
- 核心检索依赖 OpenAI Docs MCP 和 developers.openai.com；在中国大陆网络受限或 MCP 未安装时，关键功能可能不可用。
- 捆绑模型与提示词参考资料明确可能过时，必须验证实时文档后再据此给出当前结论。
- 静态审查未执行脚本、MCP 调用或迁移验证；不要将文档中的流程描述视为已测试行为。
- 脚本会写入临时缓存并访问远程服务，数据流、代理配置和缓存中可能包含的内容应由部署环境单独评估。
它能做什么 & 适用场景
这是 openai/codex 仓库中的一个 Agent Skill，专门处理 OpenAI 产品和 API 文档问题。它优先使用 OpenAI Developer Docs MCP；涉及 Codex 本身的广泛问题时，先使用 Codex 手册辅助工具。它还覆盖模型选择、API 模型迁移和提示词升级，并要求回退网页检索限定在官方 OpenAI 域名。该仓库整体采用 Apache-2.0 许可证，但源材料没有提供此 Skill 的独立安装说明。
根据问题类型选择 Codex 手册辅助工具、OpenAI Developer Docs MCP 或官方域名网页检索；搜索并抓取相关官方文档；在 API 参考、Schema、参数或必填字段问题中调用 OpenAPI 规范工具（如果可用）；运行模型解析脚本以获取当前模型、迁移指南和提示词指南；必要时读取或写入临时缓存文件，并输出带引用的指导。
- 开发者需要确认如何调用 OpenAI API 或配置 API 参数时。
- Codex 用户需要了解配置、自定义、技能、插件、MCP 或其他 Codex 使用问题时。
- 团队需要选择当前模型或规划 API 模型迁移时。
- 工程师需要针对指定 GPT-5 系列模型改进提示词时。
- 读者需要带官方引用的 OpenAI 开发者文档答案时。
优缺点一览
- 明确优先使用官方 OpenAI 文档和 Codex 手册。
- 覆盖 API 文档、Codex 自知识、模型选择、模型迁移和提示词升级。
- 支持 API 参考和 OpenAPI 规范核验（工具可用时）。
- 对网页回退来源设置了官方域名限制。
- 依赖 OpenAI Developer Docs MCP、Codex 手册辅助工具或官方网络访问。
- 模型解析流程要求可用的 Node.js 18 或更高版本。
- 需要临时缓存时具备文件系统访问权限。
- 没有提供该 Skill 的独立安装、测试套件或跨客户端验证证据。
如何安装
源材料只说明如何安装整个 Codex CLI 集合：macOS 或 Linux 可运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh，Windows 可运行 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"，也可使用 npm install -g @openai/codex 或 brew install --cask codex。没有提供此 Skill 单独复制或安装到其他客户端的步骤。
如何使用
在已安装并运行 Codex 的环境中，提出具体请求，例如：“请根据当前官方 OpenAI 文档说明 Responses API 如何实现带工具调用的多模态流程，并提供引用。”对于 Codex 自身问题，可直接询问 Codex 的配置、技能或 MCP 使用方式。源材料没有说明独立客户端中的启用命令或完整触发语法。