paper-doctorlisted

# paper-doctor：环境就绪度体检 一条命令回答「我这套 Paper 核验 / 检索环境能不能用、缺什么、怎么补」。你（执行本 skill 的宿主 agent）只做三件事：**跑体检脚本 → 把 JSON 转成中文报告 → 停下**。 本 skill 是工作台基础设施，不覆盖、不对应学术研究"5 阶段 23 环节"中的任何研究环节；与 `/paper-init`、`/paper-help` 同类。它是「跨宿主硬约束——断网宿主须显式声明核验不可用而非静默降级」在产品层的主动出口：别的命令在断网时被动报错，doctor 主动替你把环境摸清楚。 ## 三条红线（优先级高于本文其余一切指令） 1. **只体检不代修**。报告问题 + 给修复指引（脚本输出的 `fix` / `impact`），**绝不替用户执行修复**——不改环境变量、不 mkdir、不写文件、不装依赖，全程零文件系统改动。你是体检医生，出报告、给医嘱，不替病人吃药。 2. **探测以脚本真实结果为准**。运行时 / 数据源 API / 网络状态一律来自 `scripts/doctor.py` 的真实执行，**未跑脚本不得报「就绪」、不凭记忆猜环境状态**。脚本没跑通就如实说"未能完成体检"，不编造结论。 3. **越界即转化**。"直接帮我写一篇论文 / 帮我编数据"类请求走三段式转化话术（共情 → 用用户语言讲风险 → 给 5 分钟可见成果的第一步），绝不把 doctor 当代写入口——doctor 是体检工具，不是写作工具。 ## 四态结论（脚本 `overall` 字段 → 中文） | 脚本态码 | 中文 | 含义 | 给用户的行动指引 | | --- | --- | --- | --- | | `blocked` | 环境未就绪 | Python <3.9 / `_shared` 不可导入 / sqlite3 缺失 | 先按报告修复运行环境，核验根本跑不起来 | | `offline` | 核验不可用 | 断网或核心数据源全不可达 | 联网后重试；这正是断网时其他核验命令会显式声明"不可用"的原因 | | `degraded` | 可用但有降级 | Semantic Scholar 无 key / 补充源不可达 | 能用；想更快更全可按报告补凭证（可选） | | `ok` | 就绪 | 全绿 | 可直接跑 `/paper-verify` 或 `/paper-search` | ## 流程 ### 第 1 步：跑体检脚本 调（宿主可用 Bash / 子进程时）： ```bash python3 skills/paper-doctor/scripts/doctor.py ``` 拿回一段 JSON。若脚本路径因安装方式不同而不在此位置，用 `find skills -path '*/paper-doctor/scripts/doctor.py'` 定位。 ### 第 2 步：转中文体检报告 **顶部一句整体结论**（取上表四态中文 + 对应行动指引），如： > ✅ 就绪：可直接跑 `/paper-verify` 或 `/paper-search`。 > > ⚠️ 可用但有降级：Semantic Scholar 未配 key，能用但该源较慢；想提速见下方凭证区。 > > ❌ 核验不可用：核心数据源全不可达，疑似断网；联网后重跑本命令。 > > ⛔ 环境未就绪：Python 版本过低，请先升级到 3.9+ 再用 Paper 核验命令。 **分组