---
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` 中至少有一个能作为协作入口
  - `.autopilot/` 如果存在，结构是否足够清晰供 Codex 只读消费
  - `.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 个改进项