用途:诊断 Codex 第三方模型 Provider 配置问题。该技能内置只读检查器,由代理自行运行,不让用户复制或执行终端命令。需要 Python 3.11 或更高版本,不全局安装、不创建虚拟环境,保留真实 CODEX_HOME。
主要能力:按问题映射公开恢复指南:--problem keep-official-login(保留官方 ChatGPT/Codex 登录同时使用第三方直连令牌)、--problem plugins-or-skills-unavailable(切换后插件或 Skills 消失)、--problem model-name-incorrect(Windows 桌面显示 Custom、slug 或错误模型名)、--problem history-missing(切换后旧任务消失)、--problem chrome-unavailable(第三方模型下 Chrome 无法调用)。省略 --problem 时报告全部五项指南。
使用方式:以用户当前项目为工作目录运行 python3 <skill-directory>/scripts/run_skill.py --problem <problem-id>;若工作目录被改变,用 --cwd <original-project> 指定原项目。默认输出即结构化健康检查报告,仅机器集成时用 --json。仅在已知活动 Codex Profile 时传 --profile。
解释结果:每项问题输出固定健康检查卡片,按当前结果、精确位置与关键参数、控制项、期望状态、修改方式、验证方式六字段顺序呈现,保留顺序与全部字段。
限制与安全:不打开或解析 auth.json,只检查是否存在;不输出令牌、Cookie、请求头、MCP 环境值、私有插件名或完整私有端点 URL;不读取任务标题、消息、预览、rollout 内容或动态工具模式;诊断期间不编辑 config.toml、模型目录 JSON、插件状态、登录状态或任务数据库;不自动修复历史 Provider 绑定。任何写入需先展示精确目标、备份方案与字段级差异并获明确确认。退出码 0 表示无错误或警告,1 为警告,2 为错误,3 为无法安全完成。若内置入口无法运行,改读 prompts/agent-doctor.zh-CN.md 手动只读流程。