OpenAI 开发文档助手
为 OpenAI 产品、API 与 Codex 提供基于官方资料的当前指导。
技能明确限定优先使用 OpenAI 官方 Docs MCP，并将回退搜索限制在官方 OpenAI 域名；API-backed 构建任务还要求先经过 API key gate，权限和数据来源边界较清晰。未说明 MCP 权限范围、用户确认、敏感数据处理、外部副作用或回滚机制，且依赖外部服务，因此扣 8 分。
工作流、回退顺序、失败后的有界不确定性和脚本错误处理写得较清楚，脚本也包含缓存校验、超时和哈希验证。静态阅读无法复现 MCP、网络或脚本关键路径，缺少提交的测试套件和 CI 覆盖，因此按静态上限保守扣分。
目标用户和场景覆盖 OpenAI API、Codex、自我知识、模型选择、迁移及提示升级，且声明了若干非适用边界。对中文用户有一定可用性但未提供中文示例；核心 Docs MCP 和官方域名访问依赖海外网络，mainland-China 可达性未证明，因此扣 4 分。
文档分层较完整，包含源优先级、工作流、边界、参考资料、脚本和依赖配置；名称与能力基本一致，维护和更新路径也有说明。未提供该技能目录中的许可证证据、版本号或变更日志，部分依赖和故障排查仍需外部环境判断，因此扣 7 分。
技能能明确指导官方文档检索、Codex 手册获取、模型迁移和提示升级，并规定引用与停止条件，核心任务价值清楚。没有技能级测试、代表性输出或用户任务验证，直接可用性和相对手工检索的收益只能部分确认，因此取静态上限 7 分。
源文件提供了较详细的流程、脚本实现和来源约束，具备一定可审计性；但没有独立第三方执行证据、测试结果或交叉验证记录，且静态审查无法验证远程 MCP 行为，因此未达到更高分。
- 核心功能依赖名为 openaiDeveloperDocs 的远程 MCP 和官方网络访问；其在 mainland-China 网络环境中的可达性、延迟和故障表现未由源文件证明。
- 未见该技能目录内的 LICENSE.txt、版本标识、变更日志或技能级测试，因此许可证合规、升级回归和关键路径可重复性需要额外核查。
- API key gate、MCP 权限范围和可能发送给远程文档服务的数据边界没有具体说明，使用前应确认凭据与请求数据治理。
它能做什么 & 适用场景
该技能面向需要 OpenAI 产品、API 或 Codex 指导的用户。它优先使用 OpenAI Developer Docs MCP 获取官方文档，并在广泛的 Codex 问题上先使用 Codex 手册辅助工具。它还负责模型选择、API 模型迁移和提示词升级建议。该技能依赖 Codex 相关工作流与 OpenAI 文档工具，移植到其他平台可能需要调整。
根据问题搜索并获取 OpenAI 官方开发者文档；在需要时获取 API 规范；运行 Codex 手册获取脚本并读取生成的手册与大纲；为模型选择、API 迁移、提示词升级和 Codex 配置等问题提供带来源的指导；在官方工具不可用时，将搜索范围限制在 OpenAI 官方域名。
- 开发者需要根据最新官方文档实现 OpenAI API 功能时
- 团队需要为 API 选择合适模型或规划模型迁移时
- 用户需要升级提示词并保持行为变化范围较小时
- Codex 用户咨询技能、插件、MCP、钩子或配置等产品问题时
优缺点一览
- 优先使用 OpenAI 官方开发者文档和 Codex 手册
- 覆盖 API 文档查询、模型选择、迁移、提示词升级及 Codex 自助知识
- 对官方工具不可用时规定了官方域名搜索回退路径
- 依赖 OpenAI Docs MCP、Codex 手册辅助工具及网络访问
- 部分流程需要 shell、Node.js 和本地文件缓存
- 源材料未提供测试套件、平台兼容性验证或单独许可证文件内容
- README 表明整个仓库已弃用，当前示例应参考 OpenAI Plugins repository
如何安装
README 说明，skills/.system/ 中的技能会随最新版 Codex 自动安装。本仓库已将该技能放在 skills/.system/openai-docs/SKILL.md；源材料未提供单独安装该技能的命令。
如何使用
直接提出 OpenAI 文档、API、模型、提示词或 Codex 相关问题，例如：“根据最新官方文档，如何选择适合多模态代理工作流的模型？”对于 API 参考、参数或必填字段问题，应同时核验 API 规范（在工具可用时）。