# Autopilot Doctor Codex

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

- Skill: `strzhao/autopilot-doctor-codex-2` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add strzhao/autopilot-doctor-codex-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/strzhao/autopilot-doctor-codex-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: strzhao (https://skillmd.com/u/strzhao)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/strzhao/autopilot-doctor-codex-2

---


# 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 个改进项