---
name: autopilot-doctor-codex
description: 在 Codex 中执行 autopilot doctor 时使用。适用于用户提到 doctor、工程健康诊断、为什么 autopilot 效果不好、Codex readiness、工程成熟度评估等场景。
---

# Autopilot Doctor for Codex

这是 Claude 版 `autopilot-doctor` 的 Codex 兼容入口。

## 基线文件

把以下文件当作详细评分与检查基线：

- `plugins/autopilot/skills/autopilot-doctor/SKILL.md`

读取基线后，按本技能的 Codex 覆盖规则执行。

## Codex 覆盖规则

- 诊断报告写入 `.codex/doctor-report.md`
- 不写入 `.claude/doctor-report.md`
- 额外检查本仓库的 Codex readiness：
  - `.codex/AGENTS.md` 是否存在
  - `.agents.md` 是否存在
  - `.codex/config.toml` 是否存在，且已启用 `codex_hooks` 与 `project_doc_fallback_filenames`
  - `.agents/skills/` 是否存在并包含 Codex 技能
  - `.codex/hooks.json` 是否存在且 JSON 合法
  - 是否仍在依赖旧的 bridge、watcher、plugin-sync、软链接共享目录方案
- 当用户传入 `--fix`：
  - 只修复用户明确同意的项
  - 优先修复 Codex 自身目录下的问题
  - 不要为了 Codex 适配去改现有 Claude 插件文件，除非用户明确要求

## 输出要求

- 评分维度、加权总分、Top 问题、Top 建议沿用基线格式
- 明确区分：
  - Claude readiness
  - Codex readiness
- 最终把完整报告写到 `.codex/doctor-report.md`
- 对用户的聊天摘要要短，重点给：
  - 总分
  - 最影响 autopilot 的 3 个问题
  - 最先做的 3 个改进项