这个 Skill 能做什么,适合哪些场景?
这是 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 开发者文档答案时。
如何安装这个 Skill?
- 核心检索依赖 OpenAI Docs MCP 和 developers.openai.com;在中国大陆网络受限或 MCP 未安装时,关键功能可能不可用。
- 捆绑模型与提示词参考资料明确可能过时,必须验证实时文档后再据此给出当前结论。
- 静态审查未执行脚本、MCP 调用或迁移验证;不要将文档中的流程描述视为已测试行为。
- 脚本会写入临时缓存并访问远程服务,数据流、代理配置和缓存中可能包含的内容应由部署环境单独评估。
- Shell / 命令行
- 网络访问
- 本地文件系统
- MCP Server
Node.js 18+
源材料只说明如何安装整个 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 单独复制或安装到其他客户端的步骤。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/openai/codex.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/codex-rs/skills/src/assets/samples/openai-docs" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 请根据当前官方 OpenAI 文档说明 Responses API 如何实现带工具调用的多模态流程,并提供引用。
在已安装并运行 Codex 的环境中,提出具体请求,例如:“请根据当前官方 OpenAI 文档说明 Responses API 如何实现带工具调用的多模态流程,并提供引用。”对于 Codex 自身问题,可直接询问 Codex 的配置、技能或 MCP 使用方式。源材料没有说明独立客户端中的启用命令或完整触发语法。
这个 Skill 有哪些优点和局限?
- 明确优先使用官方 OpenAI 文档和 Codex 手册。
- 覆盖 API 文档、Codex 自知识、模型选择、模型迁移和提示词升级。
- 支持 API 参考和 OpenAPI 规范核验(工具可用时)。
- 对网页回退来源设置了官方域名限制。
- 依赖 OpenAI Developer Docs MCP、Codex 手册辅助工具或官方网络访问。
- 模型解析流程要求可用的 Node.js 18 或更高版本。
- 需要临时缓存时具备文件系统访问权限。
- 没有提供该 Skill 的独立安装、测试套件或跨客户端验证证据。
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| OpenAI 官方文档助手 本页 ✓ OpenAI · 官方 | 52 · 谨慎使用 | ★ 129k | 11 天前 | Apache-2.0 |
| OpenAI 开发文档助手 ✓ OpenAI · 官方 | 55 · 谨慎使用 | ★ 28k | 4 个月前 | — |
| Azure OpenAI 模型部署助手 ✓ Microsoft · 官方 | 52 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Engram 持久记忆协议 | 68 · 推荐 | ★ 7.2k | 11 天前 | MIT |
| Xberg API 服务器与 MCP 协议集成 | 52 · 谨慎使用 | ★ 9.4k | 11 天前 | MIT |
FollowSkills 如何评估这个 Skill?
技能明确限定使用 OpenAI 官方文档 MCP,并将网页回退限制到官方域名;API 密钥门控、只读检索与外部动作边界有所说明。扣分在于未完整说明 MCP 数据流、凭据敏感信息处理、用户确认、回滚机制及网络依赖风险。
文档包含清晰的路由规则、失败回退、缓存校验、超时和错误处理说明,脚本实现也有哈希验证与原子写入。静态审查无法执行关键路径,且 MCP 工具可用性、Windows/代理环境和远程响应兼容性未由测试证明,因此不超过静态上限并扣分。
目标用户和主要场景较清楚,覆盖 OpenAI 文档、Codex、自身模型选择和迁移指导;也声明了部分非适用边界。扣分在于触发条件较复杂,中文输出支持未明确,核心功能依赖 developers.openai.com MCP/官方网络,可能受中国大陆网络可达性影响。
目录结构、工具依赖、引用材料、回退策略和 Apache-2.0 许可清楚,渐进披露较完整。扣分在于缺少独立版本号、变更日志、维护责任人和明确更新流程;本地引用内容还明确承认可能漂移。
对需要当前 OpenAI 文档、Codex 自知识和模型迁移的任务,路由和输出指导具有直接价值,且包含模型选择、兼容性和验证清单。静态材料没有代表性输出或运行证据,远程工具不可用时仍可能需要人工处理,因此按静态上限评为核心任务可完成但证据有限。
脚本提供 HTTP 哈希校验、缓存状态和可审计的本地手册路径,引用 URL 与工具名称也较具体。扣分在于没有提交覆盖关键路径的测试、CI 执行证据或第三方复核;多数能力依赖运行时 MCP/网络,静态材料只能支持有限可验证性。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →