codex-skill-doctor

codex-skill-doctor 是一个很小的本地 proof，用来检查一条固定规则：目标仓库里是否存在预期的本地 skill wrapper 文件 skills/<repo-name>/SKILL.md。

当前发布的 CLI 面非常小，只保留一个诊断入口：

codex-skill-doctor doctor <repo>
python -m codex_skill_doctor doctor <repo>

missing_wrapper 的含义

扫描器会根据你传入的仓库目录名，推导出期望的 wrapper 路径。

• 健康仓库：存在 skills/<repo-name>/SKILL.md
• 失败仓库：缺少这个文件，因此 CLI 会报出一个名为 missing_wrapper 的 finding

这个 proof 不包含网络访问、自动修复，也不会真正调用 Codex。

本地安装

python3 -m venv --system-site-packages .venv
.venv/bin/python -m pip install --no-build-isolation -e .

本地示例

健康 fixture：

.venv/bin/python -m codex_skill_doctor doctor tests/fixtures/repos/healthy-repo

预期结果：退出码为 0，并且输出 findings: none。

失败 fixture：

.venv/bin/codex-skill-doctor doctor tests/fixtures/repos/missing-wrapper-repo

预期结果：退出码为 1，并且输出一个指向 skills/missing-wrapper-repo/SKILL.md 的 missing_wrapper finding。

验证命令

python3 -m unittest discover -s tests
python3 -m venv --system-site-packages .venv
.venv/bin/python -m pip install --no-build-isolation -e .
.venv/bin/python -m codex_skill_doctor doctor tests/fixtures/repos/healthy-repo
.venv/bin/codex-skill-doctor doctor tests/fixtures/repos/missing-wrapper-repo

当前范围

• 只支持一个命令：doctor <repo>
• 只支持一条规则：missing_wrapper
• 只验证本地 fixture 仓库，不依赖真实 Codex 环境
• 不做自动修复、不做联网检查、不扩展成多规则框架