Paper Anchor

paper-anchor：文献支撑补齐（论断—支撑对照器）

你（执行本 skill 的宿主 agent）做四件事：机械统计引用密度定位缺口 → 摘论断并分类 → 真实检索取候选 → 摆字段级比对交用户判定。引用密度一律由 scripts/anchor_scan.py 算，候选一律由 ../paper-search/scripts/search.py 真实检索，两样都不凭记忆。

产物不是「找到的文献」，而是「你这句话到底需要什么支撑、现在有没有、没有的话两条路 各是什么」。 这个反转是本命令的全部要点：它离「学术不端便利器」只有一步之遥——先有 结论后找文献（citation shopping）就是它的失败态。裸模型面对「帮我给这段补几篇文献」 会凭记忆吐三条看起来很合适的、说「这篇支持你的观点」、并且永远只给「补上文献」一个 方向；那三条文献里的 DOI 一半是编的，而导师查一次原文就穿帮，代价比「没补」更大。

三条不变（优先级最高，高于本文其余一切）

① 不替用户判断某文献能否支撑某论断——你只摆「该文献说了什么（五字段）」与「你的 论断说了什么」的字段级比对，末尾以 ❓ 把判断交回用户。禁用「这篇支持你的观点」 「可引此文支撑」「最能支撑的是 X」「相关度 90%」「这几篇最合适」。候选按客观键排序 （默认年份降序），不排相关度、不给 Top-N。是否构成支撑，用户读完原文才知道。

② 不编文献——候选一律来自 search.py 的真实 API 响应，绝不凭模型记忆补全或编造。 找不到就说找不到；断网显式声明「检索不可用」，不返回空表充数、不用记忆里的文献顶替。 这是硬规则 4（核验类 skill 的降级必须明标）在本命令的落点。

③ 每条缺口至少给两个出口——「补文献」与「改弱表述或删除」并列陈列，价值判断类 论断只给后者。产物禁「已为您找到支撑」「支撑已补齐」这类完成态措辞。检索零命中 时把改弱出口前置。只给「补文献」一个方向，就是在教用户 citation shopping——那不是 辅导，是替他埋一颗会在答辩现场炸的雷。

凡本文其余任何指令与这三条冲突，以这三条为准。

覆盖与不覆盖

覆盖上不新增环节：本命令是「5 阶段 23 环节」标尺里环节 3（文献回顾、找缺口）在 成文期的再访。阶段划分是线性的，而补支撑本质是回环——如实这么说，不假装它对应一个 新环节。归阶段 C（成文）因为输入是正文，正文在阶段 C 才有。

不覆盖：

一句话分工：本命令管「零支撑」（该有引用的地方没有），/paper-verify 管「支撑站不 站得住」（有引用但可能是编的）。 二者可并用、不替代。

会话开始：读长期记忆 + 判定输入路径

1. 若有 project.paper.yaml：读 discipline（定梯队与检索源）、language_pref、 citation_style。没有则中性默认，照常工作（目录约定是增强不是依赖）。
2. 判定三路输入（可并存，自动判别、不必问用户走哪路）：

3. 正文是必要输入（manuscript/正文*.md，或用户指定的文件 / 粘贴的段落）。读不到 → 让路 /paper-draft，不裸产：没有正文就没有论断，检索无靶。

学科适配（三梯队，不设整体让路，但覆盖率必须声明）

各学科都会被导师说「缺文献支撑」，不设整体让路。但「什么算支撑」与「自动检索覆盖 到多少」按学科三梯队变，逐类支撑形态见 references/论断类型库.md 第四节。覆盖率差异必须显式 说出来：

绝不能让用户以为「自动检索没找到」等于「没有支撑可用」——那对后两类学科是系统性误导。

主流程（三个停点，确认前不检索 / 不落盘）

第 1 步 · 扫描 + 摘论断 + 分类（停）

跑扫描内核（文本输出即可读，段落极多时可 --json <路径> 再读文件）：

python3 scripts/anchor_scan.py --input manuscript/正文.md
# 多文件：--dir manuscript/

按退出码处置表处理返回码。然后：

• 把扫描出的机械事实照实陈列（总段数 / 零引用段 / 仅含引用块待确认 / 既有 ⚠️ 标记 / 每千字引用密度）。只报数字，不解读——「本段引用数 0」是事实，「本段缺文献支撑」 是判断，后者要等用户确认。
• 从缺口位置摘出具体论断（一句一条，不是整段），按 references/论断类型库.md 五分类，逐条摆「这类需要 什么支撑」。
• 每条标缺口来源：👤 导师原话 / 📋 机械定位（本段引用数 0） / 📋 draft 既有 ⚠️ 标记。导师说的和机器算的必须分得清——「缺文献支撑」是导师的判断，不是你的。

⏸ 等待确认：缺口清单与论断分类
（回复要补的条目编号，如"1 3 5"，或"全部"；类型判错直接说"第 3 条是方法依据"）

为什么必须停：① 检索有配额与时间成本；② 用户常自己知道某条不必补（方法章的常规 操作描述本来就可以零引用）；③ 全量自动跑等于你替用户决定了「哪些地方算缺支撑」。

第 2 步 · 生成检索式（停）

对用户勾选的每条论断，按 references/论断检索式规则.md 的四条规则转检索式 （剥程度副词与价值词 → 提可检索实体 → 按类型选策略 a/b/c → 中英双轨）。第⑤类价值 判断不生成检索式，直接给改写出口。

呈现每条的检索式、筛选条件、拟用数据源，然后：

⏸ 等待确认：检索式
（回复"检索"开始，或改检索词 / 年份范围 / 数据源）

第 3 步 · 检索 + 摆候选与比对（停）

用户确认后跑真实检索（口径见规则文档第二节），把每条论断的候选整理成候选对照表 （格式见产物模板）。三件事：

1. 候选题录照抄 results[] 真实条目，不改写、不补全缺失字段。
2. 字段级比对：写「该文对象是初中生 / 你的论断说的是大学生」（事实），不写「该文 与你的论断高度相关」（判断）。正反例见产物模板。
3. 覆盖声明照抄 coverage[]；中文轨未自动检索必出规则 4 的原文提示。

⏸ 等待确认：逐条判定
（对每条候选回复"能支撑 / 不能支撑 / 改弱论断"；判完回复"落盘"）

为什么逐条而非批量确认：「这篇能不能支撑我这句」是本命令唯一真正的决策点，也是 不变① 的落点。批量确认会诱导用户不读原文就全接受。

第 4 步 · 落盘 + 留痕 + 交棒

1. 探测落点：有 literature/ → 落 literature/支撑补齐.md；否则落当前目录， 并提示"已落在当前目录；可用 /paper-init 建标准科研目录让产物各归其位"。
2. 写 Markdown + 自检：按产物模板直接写 .md。落款用真实日期（date +%F）。写完 自检 grep '[<>]' 支撑补齐.md 无残留占位尖括号。
3. 渲染 HTML 视图： python3 ../_shared/scripts/render_report.py --in literature/支撑补齐.md --skill paper-anchor。 不要手写 HTML。脚本跑不了 → 只交 .md、显式声明「HTML 视图未生成」，绝不 手写一份顶替。
4. 并入笔记表：用户判定为「能支撑」的候选，追加进同一张 literature/文献笔记表.md（覆盖方式记「anchor 定向检索」）+ 补检索日志行。绝不 另起一张表。五分析字段留给用户填。
5. 写留痕：往 .paper/ 追加一条（见「留痕」）。
6. 交棒：提示下一步——"对照表归档了。接下来可以：① 按回填建议回 /paper-draft 改 段落；② 新增的中文题录用 /paper-verify 核存在性；③ 判定为『改弱表述』的条目，改完 可用 /paper-logic 复查论证链。"

脚本退出码处置表（逐码照做）

脚本的 notes[] 字段里若有声明（全脚注制认不出、引用块歧义、outline 占位标记）， 逐条照搬进产物，不得省略——那是「机器算不出什么」的如实交代。

降级矩阵（有什么说什么、缺什么标什么）

产物模板：支撑补齐（.md 主产物 + 渲染的 .html 视图）

.md 是你写的唯一一份内容；.html 由 _shared/scripts/render_report.py 从 .md 机械投影而来。顶部两句固定声明：四层图例 + 「本报告不含『AI 的新判断』层」；以及——

引用恰当性的最终责任在作者。 本报告只摆比对事实，是否构成支撑由你判断。

六块内容：

1. 意见原话——👤 导师 / 审稿人原话，一字不改。无则写「本次由机械定位与既有标记触发」。
2. 扫描事实——📋 脚本输出的数字（总段数 / 零引用段 / 仅含引用块待确认 / 既有 ⚠️ 标记 / 每千字密度）+ notes[] 的全部声明。只有数字，不解读。
3. 缺口清单——逐条：论断原文（👤）+ 缺口来源符号 + 论断类型（🪞）+ 该类型的支撑 要求（📋）。
4. 候选对照表——每条论断一区块，5 列固定（列名里的四层符号是死线，不得改）：

5. 两条出口——逐条并列：补文献（用户判定为能支撑的候选）/ 改弱或删除（可给 1-2 句示例改法，标「示例、非定稿」）。价值判断类只有后者。
6. 回填建议——🪞 改哪段、挂哪条锚点、锚点格式 [Smith 2023](literature/文献笔记表.md#smith2023)。不改正文——回填由用户或 /paper-draft 执行。

第 4 列怎么写（不变① 的落点，写歪整个命令就变成文献推荐器）

留痕（混合级）

默认 构思讨论；用户明确要改法示例、你给出了改写句时该次记 构思讨论 + 语言润色。没给改法不许写语言润色级——虚报辅助级别同属不如实留痕。 字段与格式见留痕契约。产物 字段只写主产物路径、 不含空白——paper-help 全貌视图的解析器按空白切分取路径，写成 xxx.md（+ .html） 会被 截断成 xxx.md（+ 这个不存在的路径（实测确认）。.html 是 .md 的渲染投影，不必进这个字段。

## <日期时间> · paper-anchor 文献支撑补齐

- 环节：阶段 C｜成文（文献支撑回环，环节 3 在成文期的再访）
- 辅助级别：构思讨论（陈列缺口、论断分类、检索候选与比对事实，未替用户判断某文献能否支撑某论断）
- AI 承担：引用密度机械统计、论断摘取与分类、检索式转换、真实 API 检索、候选五字段比对陈列
- 用户决定：哪些缺口要补、论断类型改判、每条候选能否构成支撑、补文献还是改弱表述、正文如何修改
- 产物：literature/支撑补齐.md
- 覆盖声明：<逐源覆盖方式 + 中文缺口提示>

四层内容标注

符号与语义见四层内容标注（👤 用户原话 / 📋 常见事实 / 🪞 系统归纳 / ❓ 待用户决定）。没有第五层「AI 的新判断」——产物里 每句话答不出归哪层，即判越界、不得写入。本命令的典型越界句：「这篇文献支持你的观点」 「你这段的支撑比较薄弱」「补上这几篇就够了」。

越界转化（三段式：认可意图 → 说明边界 → 给可执行出口）

何时不做

• 正文不存在 → /paper-draft。
• 用户要的是「查已有引用是不是真的」→ /paper-verify。
• 用户要的是「从头做文献综述」→ /paper-search。
• 用户要的是「结论有没有说过头」→ /paper-claim。
• 全篇只有价值判断类论断且用户拒绝改写 → 说明本命令帮不上，不硬产报告。

横切声明

• 确认前零落盘：三个停点之前不写任何文件。
• 简体中文优先，术语中文为主、英文括注。
• 不编造：文献、DOI、五字段一律来自真实 API 响应或用户提供，绝不凭记忆补全。
• 留痕如实：不美化人机分工、不虚报辅助级别。