用途
本技能用于诊断 Codex 相关问题,适用对象包括 Codex 应用、CLI、IDE 扩展、Web 界面、插件、MCP、Hook、技能、子智能体、浏览器、Computer Use、连接器、认证、沙箱、权限、自动化以及日志。
主要能力
该技能采用文档优先的排查思路,不依赖记忆或本地传闻,因为当前 Codex 行为可能已经变化。流程是先识别受影响的 Codex 层面,再查阅对应层面的 OpenAI Codex 官方文档;官方开发者文档 MCP 可用时优先使用它,不可用时仅使用官方 OpenAI Codex 文档。
完成文档核对后,再检查本地实际情况,包括:codex --version;在涉及整体安装或运行时健康时使用 codex doctor;用 codex features list 查看功能标志;排查插件问题时用 codex plugin list 与插件市场状态;排查 MCP 问题时用 codex mcp list;此外还检查 ~/.codex/config.toml、~/.codex/hooks.json、相关应用日志与会话记录,以及仅在怀疑缓存或物化失败时检查插件缓存路径。
使用方式
诊断前先分离层次:官方文档行为、已安装 CLI/应用版本与功能标志、本地配置、插件或 MCP 注册、缓存/物化的运行时文件、目标应用/浏览器/连接器状态。若文档与本地行为不一致,应报告这一不匹配并保留不确定性。
适用场景
- Codex 应用或 CLI 出现异常行为
- 插件、MCP、Hook 注册或启用问题
- 认证、沙箱、权限或自动化配置疑问
- 浏览器、Computer Use 或连接器问题
- 需要基于官方文档与本地证据进行系统排查
限制与约束
未经用户要求,不修改 Codex 配置、Hook、插件或缓存;未经明确批准,不删除缓存或宿主状态文件。不得仅凭插件列表或工具列表推断连接器认证已可用,应使用可用的只读身份或资源检查。对于浏览器问题,需区分 Codex 内置浏览器、Chrome 扩展和 Computer Use;对于 Hook,需分开功能启用与 Hook 条目配置。最终输出应包含:观察到的事实、官方文档依据、本地证据、可能原因或明确标注的假设,以及确切的下一步修复或验证步骤。