Agent Doctor

诊断 Codex 自定义 subagent TOML 的可用性——能否被 Codex 正确加载并按预期运行。配套的 agent 创建/编写用 agent-creator，本 skill 只读检查、不改写 agent（修复需用户确认）。

Contract

单一职责：扫描一个或多个 agent TOML，逐个给出 PASS / WARN / FAIL 与原因。

不允许：

• 在未经用户确认的情况下改写 agent 文件。
• 安装、发布 agent 或修改全局 Codex 配置。
• 真正启动 MCP server 进程或调用其工具（只检查命令是否存在）。

为什么需要

Codex 的 agent 是 TOML。TOML 有一条致命规则：任何 [table] 表头（如 [mcp_servers.x]、[[skills.config]]）会吞掉它之后所有的裸键。如果把 mcp_servers 写在 developer_instructions 之前，developer_instructions 会被解析成 mcp_servers.x.developer_instructions，于是这个 agent 没有任何指令——文件能正常解析、不会报错，但 agent 实际是哑的。本 skill 的首要任务就是抓出这类静默失效。

检查项