git:20260330.3ff9f87 to git:20260404.d87865b

---

name: autopilot-doctor-codex

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

---

# Autopilot Doctor for Codex

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

## 基线文件

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

- `baselines/claude-autopilot-doctor.md`

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

## Codex 覆盖规则

- 诊断报告写入 `.codex/doctor-report.md`

- 不写入 `.claude/doctor-report.md`

- 额外检查当前项目的 Codex readiness：

- 是否还能在没有 repo-local launcher、bridge、watcher、plugin-sync 的情况下工作

- `.codex/` 目录是否存在或可安全创建

- 当前项目说明是否清晰可发现，例如 `.agents.md`、`AGENTS.md`、`CLAUDE.md` 中至少有一个能作为协作入口

- `.codex/hooks.json` 是否包含可工作的 `Stop` runtime，而不只是轻量提示 hook

- 是否仍在依赖旧的 bridge、watcher、plugin-sync、软链接共享目录方案

- 当用户传入 `--fix`：

- 只修复用户明确同意的项

- 优先修复 `.codex/` 下的问题或补充当前项目的 Codex-facing 文档

- 不要为了 Codex 适配去改现有 Claude 插件文件，除非用户明确要求

## 输出要求

- 评分维度、加权总分、Top 问题、Top 建议沿用基线格式

- 明确区分：

- 通用工程 readiness

- Codex autopilot readiness

- 最终把完整报告写到 `.codex/doctor-report.md`

- 对用户的聊天摘要要短，重点给：

- 总分

- 最影响 autopilot 的 3 个问题

- 最先做的 3 个改进项