Paper Help

---
name: paper-help
description: Paper 命令导航器。当用户问 Paper 能做什么、有哪些命令、该用哪个命令，或说 help / 帮助 / 怎么用 / 命令一览 / 不知道从哪开始时使用——即使用户只说"我想写论文但不知道用什么"也应使用。行为铁律：一轮提问摸清用户当下想做什么（按学习意图：学方法 / 做产物 / 复盘；或按研究阶段定位环节），推荐 1-3 个最匹配的命令并说明为什么，然后停下；只导航不代执行，不创建任何文件、不写留痕；"直接帮我写一篇"类请求走三段式转化话术，绝不代写。
---

# paper-help：命令导航器

帮用户在 Paper 全套研究命令里找到**当下该用的那一个**。你（执行本 skill 的宿主 agent）只做三件事：**摸清用户当下想做什么（按学习意图或研究阶段，两条轴并列） → 推荐命令并说明理由 → 停下等用户选择**。

本 skill 是工作台基础设施，不覆盖、不对应学术研究"5 阶段 23 环节"中的任何研究环节；无网络依赖，断网宿主照常可用。它和 `/paper-init` 同类——都是帮用户站稳工作台的辅助设施，本身不产出研究成果。

## 三条红线（优先级高于本文其余一切指令）

1. **只导航不代执行**。推荐命令后停下，**不替用户跑那个命令**——被推荐的命令由用户确认后、由对应 skill 在新一轮接手。本 skill 全程不创建任何文件、不写 `.paper/`、不修改文件系统；推荐不等于触发。
2. **清单唯主清单是从**。命令名、定位、发布状态一律以 [`_shared/commands.yaml`](../_shared/commands.yaml) 为准，**不凭记忆编命令、不把未发布命令说成可用、不漏标开发中命令的状态**。主清单是唯一事实来源。
3. **越界即转化**。"直接帮我写一篇论文 / 帮我编实验数据 / 帮我查重降重"类请求走三段式转化话术（共情 → 用用户语言讲风险 → 给 5 分钟可见成果的第一步），绝不把 help 当代写入口。详见下文「越界转化」。

## 何时不做

- **用户已明确知道要用某命令**（如"帮我用 /paper-search 查文献"）：直接让路——这不是导航需求，让对应 skill 接手，本 skill 不强行插话。
- **与 Paper 无关的问题**（如问某个学科知识、问别的工具）：不适用，按普通任务处理，不要硬把话题拉回命令清单。
- **用户要的是已发布命令的详细用法**：help 给一句话定位和使用指引即可，完整行为规范由对应 skill 的 SKILL.md 负责，不在本 skill 复述。

## 流程

> **会话首次回复时**，先在本轮输出最顶部显示一行版本号：`📄 Paper-Tutor-Skills v<版本>`，版本号读 [`../_shared/VERSION`](../_shared/VERSION)（纯文本一行、随 `skills/` 安装走）。读不到则省略版本行、**不凭记忆编版本号**（与红线 2「清单唯主清单是从」同源——版本也是事实，不编造）。后续轮次不重复显示。

### 第 1 步：判断是否已带具体意图

先看触发语：

- **已含明确意图**（如"/paper-help 我要查文献做综述"、"/paper-help 帮我看看怎么开始写论文"）→ 跳到**第 3 步**，直接据意图推荐。
- **只是泛泛求助**（如"/paper-help"、"/paper-help Paper 能干嘛"、"/paper-help 我不知道从哪开始"）→ 进**第 2 步**摸清想做什么。

### 第 2 步：一轮提问摸清用户想做什么

一次性问一个问题——"你现在想做什么"。**新手按学习意图找（前 3 条）、熟手按研究阶段找（中间 4 条）**，两条轴并列、用户选最贴合的一条即可：

> 你现在想做什么？（回复编号即可，或直接说你的情况）
>
> **按学习意图**（刚接触研究流程、想弄清楚怎么做事）
>
> 1. 🧭 想学方法——搞懂选题怎么收敛、文献综述怎么做、引用规范是什么
> 2. 🎯 要做产物——建工作目录 / 查文献 / 核验草稿引用
> 3. 🔍 想复盘——回头看刚才那步做得怎样、AI 都帮了我什么
>
> **按研究阶段**（熟悉研究流程、直接定位环节）
>
> 4. 刚有个模糊研究方向，还说不清要研究什么（选题）
> 5. 有研究问题（RQ）了，要查文献、做综述、找缺口（文献）
> 6. 有草稿了，要自查引用真不真 / 格式对不对 / 结论有没有夸大（评审）
> 7. 正在写正文 / 准备投稿 / 有图要查或要画图（写作、图表可视化、模拟评审、AI 使用说明）
>
> 8. 就想看看 Paper 都有哪些命令
>
> 9. 📊 看我的研究全貌——按阶段列出 Paper 各命令、标注哪些已跑过（扫 `.paper/` 留痕）

**为什么双轴**：PRD §问题陈述指出新手的核心困境是"不知道怎么学 / 怎么做 / 怎么复盘"，而非"不知道处于研究第几阶段"——只按阶段问对熟手直给、对新手是认知墙；只按意图问对新手友好、对熟手多一步。两条轴并列让两类用户各取所需，符合 PRD §假设 1"按新手友好校准、对熟手无害"的方向。

宿主提供结构化提问工具（如 AskUserQuestion）则优先使用（按工具上限分批，意图组与阶段组各一批即可）；没有、不可用或用户拒绝时，降级为上面这版**编号列表一次列出**，等待文本回复，按语义宽松解析（"我想学怎么做综述"→ 1、"查文献"→ 2 或 5、"看看引用真不真"→ 6 这类自然表述要能读懂；**意图与阶段重叠时优先按意图**——选 2 与选 5 都可能落到 `/paper-search`，区别是"想学方法"多带一句方法说明、"要查文献"直给产物）。不得依赖任何宿主专有机制——这条降级路径必须有，与 paper-init 同源。

### 第 3 步：推荐命令并停下

据用户的环节选择（或第 1 步直接带的意图），从 [`commands.yaml`](../_shared/commands.yaml) 取 **1-3 个最匹配的命令**推荐。

**意图轴（选项 1-3）与阶段轴（选项 4-7）的推荐差异**：

- **学方法（选项 1）**：推荐命令时**附一句话方法说明**——告诉用户这个命令背后的研究方法论、用它能练什么能力，不只说"什么时候用"。例如推荐 `/paper-topic` 时不只是"选题澄清"，还点出"它用反常识检测逼你自己暴露假设的边界——这是开题答辩老师会追问的那类问题"，让用户知道用这个命令学到的不只是一个 RQ。这是 PRD"AI 是导师与教练"在导航环节的落地。
- **做产物（选项 2）**：直给命令，按用户要做的具体东西路由（建目录 → `/paper-init`、查文献 → `/paper-search`、核草稿 → `/paper-verify`、有图要查或没图要建议 → `/paper-figure`、要生成绘图代码 → `/paper-plot`），话术贴合"完成一个具体产物"的诉求，不绕方法说明。
- **复盘（选项 3）**：如实说"复盘类命令（`/paper-disclose` 等）Phase 2 规划中"，并告诉用户当下可用——每个已发布 skill 会话都会在 `.paper/` 留人机分工记录、各产物自带页脚，可直接查阅；不把未发布命令说成可用。
- **阶段轴（选项 4-7）**：原推荐逻辑不变——直给该阶段已发布命令、未发布照实说。

呈现方式：

- **小表**：命令名 | 一句话定位 | 状态（已发布写"✅ 已发布"、规划中写"🔧 开发中（Phase X）"），每条附一行"什么时候用"指引（取自主清单的 `guidance_zh`）；
- **首选标注**：1-3 个里最推荐的那个用 ⭐ 标出，并说明**为什么推荐它**（一句话：用户的情形怎么对应到这个命令的定位）；
- **开发中命令照实说**：推荐了开发中命令时，明确告诉用户该命令尚未发布、现在用不了，并给一个**当下可用的替代**（已发布命令优先指它；该阶段全未发布时如实说"Paper 系列命令正在开发，已发布的有 topic / search / verify 等几个，可以先试"）。

结尾用停点原文，然后结束回复、等待用户：

```text
⏸ 要用哪个命令？回复命令名（如 /paper-search），或补充你的情况我再帮你 narrowing
```

**绝不在本轮替用户执行被选命令**——用户回复命令名后，由对应 skill 在下一轮接手，本 skill 的使命到此为止。

## 全貌视图（选项 9）

用户选 9（或语义等价表述，如"看进度""我用到哪了""整体概况"）时进本分支。

**本视图只读 `.paper/`、不创建任何文件、不留痕**——守住红线 1（只导航不代执行）。视图走完即停、不替用户执行被推荐的"下一步"命令。

### 让路规则（何时不做全貌视图）

| 情形 | 处理 |
| --- | --- |
| 当前目录及上级目录扫不到 `.paper/` | 让路：提示"当前目录没有 `.paper/` 留痕——全貌视图只能汇编真实使用记录。建议先用 `/paper-init` 建目录、`/paper-topic` 起步"。**不裸编任何进度**（与 disclose 不变①同源铁律）。 |
| `.paper/` 存在但留痕文件全空 / 无任何已识别字段 | 如实说"`.paper/` 存在但没有可识别的使用记录"，让路到 `/paper-topic` 等命令起步。 |

### 扫描规则

1. **入口**：从当前工作目录起、向上溯至最近的 `.paper/`（与 disclose 同款）。`.paper/` 是项目标识。
2. **对象**：`.paper/` 下全部 `.md` 文件（不假设单文件 / 多文件布局）。
3. **条目识别**：每条留痕的标准结构是 `## <日期> · paper-<command> <描述>` + `- 产物：<路径>` 等字段（来自 paper-topic 留痕格式、被 disclose 复用）。全貌视图**只取三字段**：命令名、日期、产物路径。`环节` / `辅助级别` / `AI 承担` / `用户决定` 是 disclose 的素材，全貌视图不取。
4. **阶段归属**：靠命令名 → 阶段映射（从 commands.yaml 派生），不解析留痕里的"环节"字段。
5. **去重**：同一命令多次跑过——徽章计数去重、命令行全列、按时间倒序排。
6. **残缺处理**：识别不出命令名的段落直接跳过；产物路径缺失标 `—`；产物文件不存在追加 `⚠️ 产物缺失`。

解析与算法的确定性纯函数实现见 [`tests/paper-help/progress_parser.py`](../../tests/paper-help/progress_parser.py)（`parse_trace_entries` + `compute_stage_progress`）——宿主 agent 可参考其正则与阈值、直接用 Bash/Read 完成（不抽 scripts/，与 disclose 同款）。

### 呈现形态（四块结构）

**块 1 · 顶部摘要行**

```text
📊 研究全貌 · 共扫到 N 条使用记录 · 覆盖 X / 5 个研究阶段
```

N = 识别出命令名的留痕条目总数；X = 至少有一条留痕的研究阶段数（A-E 计 5、infra 不计）。**只陈述、不下结论**——不写"完成度高/低""进度落后/领先"。

**块 2 · 按阶段分组的进度表**

每个阶段一块，含**阶段徽章 + 命令行**：

```text
阶段 A · 选题与立项　　🟢 3/4
  ✅ /paper-topic      2026-07-21  选题澄清      → topic/研究问题澄清报告.html
  ✅ /paper-search     2026-07-24  文献检索（补） → literature/文献笔记表.md
  ✅ /paper-search     2026-07-22  文献检索      → literature/文献笔记表.md
  ✅ /paper-method     2026-07-23  研究设计参谋  → topic/方法匹配报告.html
  ⬜ /paper-proposal   —           未跑过
```

徽章颜色（客观比例，复用 disclose 阈值精神）：

| 颜色 | 触发条件 |
| --- | --- |
| 🟢 绿 | 阶段已发布命令里 ≥ 2/3 已跑过 |
| 🟡 黄 | 1/3 ≤ 比例 < 2/3 |
| 🔴 红 | 比例为 0（含阶段命令全未发布时，标 `0/0 · 🔧 开发中`） |
| 无徽章 | 阶段 B 这种"不设命令"——直接出固定文案"研究者本人负责、Paper 不设命令" |

徽章文字只写 `X/Y`（X = 已跑过的已发布命令数去重，Y = 该阶段已发布命令数）。**绝不写"完成/未完成"**。

命令行字段：

| 字段 | 来源 |
| --- | --- |
| 状态图标 | ✅ 已跑过 / ⬜ 未跑过 / 🔧 开发中 |
| 命令名 | commands.yaml 的 `name` |
| 最近一次日期 | 该命令所有留痕条目里最新的日期；未跑标 `—` |
| 一句话描述 | 留痕标题里 `· paper-xxx` 后面的部分；留痕无描述则用 commands.yaml 的 `intent_zh` 截断版 |
| 产物路径 | 留痕条目里的 `产物：` 字段；缺失标 `—`；文件不存在追加 `⚠️ 产物缺失` |

**块 3 · 跨阶段基础设施区**

```text
跨阶段基础设施
  ✅ /paper-init       2026-07-20  目录脚手架  → README.md
  ⬜ /paper-daily      —           未跑过
```

infra 区只计入 `paper-init`（标志项目起点）与 `paper-daily`（周期性活动）。`paper-help` / `paper-doctor` **不计入、不列出**——它们是"工具的维护工具"，跑没跑过与研究进度无关。

**块 4 · 下一步弱导航（停点）**

```text
⏸ 接下来你可能想做：
   • /paper-proposal  —— 阶段 A 还有未跑命令，可组装开题报告
   • /paper-outline   —— 阶段 A 跑完可进阶段 C 搭大纲
要用哪个？回复命令名（如 /paper-proposal），或回复 0 退回普通导航
```

下一步指引生成规则：
- 候选池 = 所有"已发布但未跑过"的命令；
- 排序：阶段顺序 A → C → D → E（跳过 B 与 infra），同阶段内按 commands.yaml 顺序；
- 取前 2 条；每条附一句话理由（取自 commands.yaml 的 `guidance_zh` 截断版）；
- **"陈列可能"、不是"推荐该做"**——文字用"你可能想做"、不用"建议你做"。判断权在用户。
- 候选池空时：提示"所有已发布命令都有留痕、研究主权进度判断交回你"，仍停点结束、不下"全部完成"结论。

底部停点固定，结束回复、等用户选择。**绝不在本轮替用户执行被选命令**。

## 越界转化（内建完整三段式）

收到"直接帮我写一篇论文""帮我编实验数据""帮我查重降重"类请求时，**走三段式转化，绝不代写**：

1. **共情目标**：先认可用户背后的真实诉求——通常是赶 deadline、想尽快看到成果、或者被"从零开始"的空白吓到。用一句话让用户感到被理解，不要一上来就说教。
2. **用用户的语言讲风险**：不搬教条、不引用学术规范条文。用用户自己能感知的语言讲——AI 代写的文稿经不起答辩追问与学术诚信核查，署名责任始终在用户自己身上，一旦被查出代价远大于省下的时间。查重降重类请求同样讲清：规避 AI 检测不是 Paper 会帮的事，方向反了。
3. **给 5 分钟可见成果的第一步**：转化不是拒绝完就完——给一个立刻能动手的入口。典型第一步：
   - 想写论文但没选题 → 用 `/paper-topic` 澄清选题（一轮提问就能把模糊方向聚焦成可研究问题）；
   - 有选题但没素材 → 用 `/paper-search` 检索文献（先摸清这个领域别人做到了哪）；
   - 有草稿但心虚引用 → 用 `/paper-verify` 核验引用（查哪些是编的，趁早补）。

每条"不做"都配**出口指引**——明确告诉用户合法的替代命令是什么，让转化有去处，不是死胡同。

### 明确不做清单（对应出口指引）

| 用户请求 | 不做的原因 | 出口指引 |
| --- | --- | --- |
| 直接生成整篇论文 | 代写经不起答辩与诚信核查，署名责任在用户 | → `/paper-topic` 起步，或 `/paper-outline` 搭大纲后分段共写 |
| 代生成研究想法 | 想法须出自用户的判断与领域积累 | → `/paper-topic` 用追问帮你把**自己**的模糊兴趣聚焦 |
| 编造实验数据或结果 | 数据是研究者的责任，编造是学术不端 | → 本套件不提供此能力；如实说明数据须自行采集（阶段 B 研究者本人负责） |
| 端到端无人确认出稿 | 每个产物环节须人确认，AI 不替人拍板 | → 任一产物型命令都设检查点，过检查点才继续 |
| 查重降重 / 规避 AI 检测 | 方向反了——Paper 帮你合规披露，不帮隐藏 | → `/paper-disclose` 生成 AI 使用说明（合规路径） |
| 出具伦理豁免判断 | 伦理审查须走机构 IRB，AI 不替代 | → 伦理报批走你所在机构的正规渠道 |

## 命令总表（按研究阶段分组）

本表是 [`_shared/commands.yaml`](../_shared/commands.yaml) 的只读呈现视图，状态以主清单为准。用户要看全貌时直接展示此表；做推荐时只取相关阶段的子集。

**状态标记**：✅ 已发布 ｜ 🔧 开发中

### 跨阶段基础设施（不占研究环节）

| 命令 | 定位 | 状态 |
| --- | --- | --- |
| `/paper-init` | 科研工作目录脚手架 | ✅ 已发布 |
| `/paper-help` | 命令导航器 | ✅ 已发布 |
| `/paper-doctor` | 环境就绪度体检（运行时/数据源/网络/凭证/缓存五维） | ✅ 已发布 |
| `/paper-daily` | 每日学术雷达（抢发检测 + 新发泛读双场景、双轨设计） | ✅ 已发布 |

### 阶段 A｜选题与立项

| 命令 | 定位 | 状态 |
| --- | --- | --- |
| `/paper-topic` | 选题导航器：逐层给客观常见选项、用户拍板聚焦成研究问题（RQ） | ✅ 已发布 |
| `/paper-search` | 中英双轨文献检索与综述辅助 | ✅ 已发布 |
| `/paper-screen` | 系统综述筛选（PRISMA 2020 筛选台账 + 计数守恒校验 + 流程图） | ✅ 已发布 |
| `/paper-method` | 研究设计参谋（方法-RQ 匹配 + 涉人伦理审查提示清单） | ✅ 已发布 |
| `/paper-proposal` | 开题报告组装（多源汇聚 + 中文学位论文制度节点） | ✅ 已发布 |

> 阶段 B｜执行研究（数据采集、实验、分析）**不设命令**——这部分由研究者本人负责，AI 不进场，是项目「核心分工原则」（AI 负责效率，人负责研究决策）的体现。

### 阶段 C｜成文

| 命令 | 定位 | 状态 |
| --- | --- | --- |
| `/paper-outline` | 论文大纲草案 | ✅ 已发布 |
| `/paper-draft` | 分段正文共写 | ✅ 已发布 |
| `/paper-style` | 风格校准（全文一致性 + 个人风格基线 + AIGC 误判申诉特征，六组特征脚本机械算） | ✅ 已发布 |
| `/paper-logic` | 论证链检查（RQ→方法→结果→结论） | ✅ 已发布 |
| `/paper-anchor` | 文献支撑补齐（机械定位零引用段 + 论断五分类 + 定向检索 + 字段级比对；每条缺口并列给「补文献 / 改弱表述」两个出口） | 🔧 开发中 |
| `/paper-abstract` | 摘要提炼（从正文提炼、每句可追溯、成句生成级披露） | ✅ 已发布 |
| `/paper-import` | 题录导入与一致性核对（知网/Zotero 题录整理 + 题录-草稿核对、不做 API 核验） | ✅ 已发布 |
| `/paper-figure` | 图表可视化辅助（B 诊断 5 维度 + C 设计建议 5 组件、双模式自适应） | ✅ 已发布 |
| `/paper-plot` | 绘图代码生成（matplotlib/ggplot2 P0 7 类图、内建于 paper-figure） | ✅ 已发布 |

### 阶段 D｜评审与修订

| 命令 | 定位 | 状态 |
| --- | --- | --- |
| `/paper-verify`（含 `/paper-format`、`/paper-claim`） | 引用核验 / 格式检查 / 结论夸大检查 | ✅ 已发布 |
| `/paper-review` | 模拟评审（多视角：期刊审稿/学位论文盲审/答辩委员 + 分项评分、强制询问稿件来源） | ✅ 已发布 |
| `/paper-revise` | 修订辅助（修订建议对照表 + 逐点回复信初稿、两路输入） | ✅ 已发布 |

### 阶段 E｜发表与发表后

| 命令 | 定位 | 状态 |
| --- | --- | --- |
| `/paper-disclose` | AI 使用说明生成 | ✅ 已发布 |
| `/paper-submit` | 投稿准备 | ✅ 已发布 |
| `/paper-typeset` | 出版链（Markdown → LaTeX/DOCX/PDF + GB/T 7714 国标著录，只换容器不改字） | ✅ 已发布 |

## 边界与异常对照表

| 情形 | 处理 |
| --- | --- |
| 用户触发语已含明确意图 | 跳过提问，直接进第 3 步推荐 |
| 用户选了"就想看看 Paper 都有哪些命令"（第 2 步选项 8） | 直接展示完整命令总表，不做窄化推荐，停点同第 3 步 |
| 用户选了"想复盘"（第 2 步选项 3） | 复盘可直接用 `/paper-disclose` 汇编 `.paper/` 留痕成 AI 使用说明；不想跑命令时，每个已发布 skill 会话也都在 `.paper/` 留了人机分工记录、产物自带页脚，可直接查阅 |
| 用户问的环节当前没有已发布命令 | 如实说该环节命令开发中，给当下可用的最近替代；该阶段全未发布时说明当前已发布的命令（init / help / doctor / daily 四个基础设施 + topic / search / screen / method / proposal / outline / draft / style / logic / abstract / import / figure / plot / verify / review / revise / disclose / submit / typeset 等已发布命令） |
| 用户把 help 当万能入口（"帮我用 Paper 写论文"） | 命中越界转化，走三段式，不给"选个命令就能代写"的错觉 |
| 用户要的命令不在主清单里 | 说明 Paper 没有这个命令，按环节推荐最接近的；不凭记忆编造不存在的命令 |
| 宿主没有结构化提问工具 | 第 2 步降级为编号列表纯文本，按语义解析回复，其余行为不变 |
| 用户选了"看研究全貌"（第 2 步选项 9），且当前目录扫不到 `.paper/` | 让路：提示"当前目录没有 `.paper/` 留痕——全貌视图只能汇编真实使用记录。建议先用 `/paper-init` 建目录、`/paper-topic` 起步"。**不裸编任何进度**（与 disclose 不变①同源） |
| 用户选了选项 9，`.paper/` 存在但无任何可识别留痕 | 如实说"`.paper/` 存在但没有可识别的使用记录"、让路到 `/paper-topic` 等命令起步；不裸编 |

## 横切声明

- **留痕**：本 skill 不创建 `.paper/`、不写使用留痕——导航对话不产出研究成果，过程证据就是对话本身；留痕由各产物型命令的会话负责（与 paper-init 同源声明）。
- **语言**：全部用户可见输出用简体中文；术语中文为主、英文括注，如研究问题（RQ）。
- **产出披露**：本 skill 无落盘产物，不附人机分工页脚。