Back to search
literature-verify
SkillWorks with Claude CodeGitHub
文献、公式、数值核查与中文文稿质量核查:逐条给「已核实/存疑/未找到」+ 作者/年份/刊/卷/页/DOI 出处字段 + 抓取文件头校验;并查不合适自造词、不合逻辑的结论、AI 味语句。核对公式数值出处、查 DOI、审稿、检查「有没有 AI 味/自造词/逻辑不通」时读。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/kongbai-lab--dsh-skill-literature-verify)HTML
<a href="/listings/kongbai-lab--dsh-skill-literature-verify"><img src="/api/listings/kongbai-lab--dsh-skill-literature-verify/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
DSHM
DSHM 的 `$DSH_HOME/skills/` 是**一个技能一个 `.md` 文件**(扁平目录):
cp SKILL.md "$DSH_HOME/skills/literature-verify.md"
重开 DSHM(或新会话)后即可使用。
Claude Code
mkdir -p ~/.claude/skills/literature-verify cp SKILL.md ~/.claude/skills/literature-verify/SKILL.md
本 skill 是纯 Markdown 指令,核心动作是检索、读原文、独立重算与写报告,不依赖特定运行时。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 342 lines
- ---
- name: literature-verify
- description: 文献、公式、数值核查与中文文稿质量核查:逐条给「已核实/存疑/未找到」+ 作者/年份/刊/卷/页/DOI 出处字段 + 抓取文件头校验;并查不合适自造词、不合逻辑的结论、AI 味语句。核对公式数值出处、查 DOI、审稿、检查「有没有 AI 味/自造词/逻辑不通」时读。
- whenToUse: 用户要求核对论文/教材里的经典公式、数值、常数、出处(作者/年份/卷/页/DOI/arXiv);给讲义补引用、做文献综述前的书目核实;审稿或自审中文文稿;或问「这段有没有 AI 味」「哪些词是自造的」「这个结论逻辑通不通」「是不是过度解读」时。
- ---
- # 文献 / 公式 / 数值核查 + 中文文稿质量核查
- 定位:**核查给证据,不给改稿。** 两件事共用一套骨架:① 事实核查(文献书目 / 公式 / 数值 / 单位 / 出处);② 文本质量核查(自造词 / 不合逻辑的结论 / AI 味语句)。流程都是「拆条目 → 逐条三档 → 出处字段 → 抓取校验 → 报告」。
- ## 0. 边界
- | 做 | 不做 |
- |---|---|
- | 核对公式、数值、常数、定义、书目出处、DOI/arXiv | ❌ 重写文章(只给"建议改法"与"改写示例") |
- | 审稿/自审:术语、逻辑、文风 | ❌ 文献综述写作(那是 `course-material` §4) |
- | 抓取校验(文件头嗅探、换源) | ❌ 排版、公式渲染(那是 `md2docx`) |
- | 给「已核实/存疑/未找到」+ 依据等级 | ❌ 替作者定稿,或替作者决定"必须改" |
- 铁律:
- 1. **没读到原文/权威数据库就标「存疑」或「未找到」,绝不写「已核实」。** 核不到就写"待核",交给用户。
- 2. **禁止编造文献、DOI、页码、式号。** 宁可少引,不可假引。
- 3. 教材/讲义的"简化"与"真错"分开:简化可能可以保留,只写清成立条件与误差;真错进 P0。
- 4. 与 `course-material` 的分工:它生产,本 skill 验收(生成后必须过一遍)。与 `md2docx`:排版与结构验收归它;与 `scifig`:图注的物理量/单位由本 skill 校。
- ## 1. 流程五步
- | # | 步骤 | 做什么 | 检查点 |
- |---|---|---|---|
- | 1 | 拆条目 | 把待核查内容拆成编号清单(建议分类:经典公式 / 数值常数 / 定义 / 书目出处 / 引文原话 / 图表来源 / 术语 / 逻辑结论 / 文风 / 单位量纲) | 每条可独立判定;一条只问一件事 |
- | 2 | 逐条三档 | 已核实 / 存疑 / 未找到;每档写依据等级(原文直读 / 权威数据库 / 二手来源 / 独立推算) | 不把"搜索摘要"当依据 |
- | 3 | 出处字段 | 每条填全 §2.1 字段;缺字段不算核实 | DOI/arXiv 可复核 |
- | 4 | 抓取校验 | 下载的文件先嗅探文件头(`%PDF`),HTML/captcha/0 字节一律失败换源(§2.6) | 每次抓取记 URL + 成功/失败 |
- | 5 | 报告 | 按 §4 格式写入任务目录;"未核实/存疑"清单显式交给用户 | 报告头写核查方式与未读原文声明 |
- ## 2. 事实核查细则
- ### 2.1 出处字段(缺一不算核实)
- | 字段 | 说明 | 示例 |
- |---|---|---|
- | 作者 | 第一作者 et al. / 全部作者 | Gray, D. F. |
- | 年份 | 出版年,注意版次年份 | 2021 |
- | 题名 | 论文/书名/章节名 | The Observation and Analysis of Stellar Photospheres |
- | 刊 / 书 | 期刊全名或出版社 | Cambridge University Press |
- | 卷 / 页 | 期刊卷页;书用版次 + 章 + 式号 + 印刷页码 | 4th ed., Ch. 18, Eq. (18.14) |
- | 版次 | 教材必填(不同版次章号/式号会变) | 3rd ed. vs 4th ed. |
- | DOI/arXiv/ISBN/URL | 至少一个可复核标识 | DOI:10.1086/130029;ISBN 978-1-009-07801-6 |
- | 读取日期 | 抓取/核对的日期 | 2026-01-01 |
- | 依据等级 | 原文直读 / 数据库书目 / 二手 / 独立推算 | 原文直读 |
- 期刊论文简式示例:**Smith, M. A., & Gray, D. F. 1976, PASP, 88, 809, DOI:10.1086/130029**。
- ### 2.2 页码、版次与式号
- - **写清版次 + 章号 + 式号**;不同版次章号/式号会变。真实教训:Gray 的旋转致宽在 3rd ed. 是 Ch. 17(具体式号未直接读到,只能写"Ch. 17"或"式号存疑"),4th ed. 是 Ch. 18, Eq. (18.14);官网目录确认 4th ed. 的章标题与 513 页。
- - 教材页码按**印刷页**,不按 PDF 阅读器页;无法确认时写"约第 N 页 / 第 N 章",别硬编。
- - 引文原话:给逐字原文 + 出处,且区分「原文引用」与「转述」(转述不加引号与书名)。真实做法:
- | 位置 | 引文 | 类型 | 出处 |
- |---|---|---|---|
- | P9 | 「……」 | 原文引用 | 作者《书名》版次 页码 |
- | P8 | ……(用今译复述原意) | 转述 | 作者《书名》 |
- ### 2.3 多来源交叉
- 优先级:**原文 / 作者官网 / 出版社页面 > ADS / SIMBAD / Crossref / arXiv > 数据库镜像 > 二手讲义/网页**。
- - 同一事实至少 2 个独立来源一致才升「已核实」;原文直读可 1 个。
- - 来源冲突时:找原始出处;仍无法判定就两组都写,标「来源冲突」,不要择一装作确定。
- - 搜索引擎摘要、百科、公众号文章只能当线索,不能当证据;必须落到书目页面或原文。
- ### 2.4 教材简化 vs 真错(单列一节)
- 不是所有简化都要改稿。判据:**这个简化在什么条件下成立、误差多大、会不会误导解题。** 输出格式:原说法 / 问题 / 建议表述 / 影响范围。
- 真实清单示例(示例物理主题,节选):
- | 原说法 | 问题 | 建议表述 |
- |---|---|---|
- | FWHM = 2Δλ_L | 实际 FWHM/Δλ_L = 1.73(ε=0)或 1.56(ε=0.6);会把 v sin i 高估 15%–28% | FWHM ≈ 1.7Δλ_L(ε=0);≈1.56Δλ_L(ε=0.6) |
- | 「第一、第二零点比值 ≈0.66 / 0.5」 | 0.66 是第一零点 q₁(ε≈0.6);刚性自转零点比值 q₂/q₁≈1.76–1.83 | 分开写 q₁ 与 q₂/q₁ |
- | v sin i 就是恒星自转速度 | 是投影值;i 未知;随机取向时 ⟨v sin i⟩=(π/4)⟨v⟩ | 每次写"投影自转速度 v sin i" |
- | 太阳自转周期 25.4 d | 25.4 d 是 Carrington 平均;赤道 24.47 d、极区约 34 d | 三个数分开写、注明定义 |
- ### 2.5 数值核查
- - **用 `python` 工具独立重算,禁止心算、禁止抄别人的中间结果**;写清「公式 → 代入 → 结果」,结果带单位与有效数字。
- - 检查项:量纲/单位/数量级/有效数字;常数取值(写出用的值);归一化与符号约定是否显式。
- - 归一化歧义是高频坑:真实案例——Gray 的旋转致宽函数 G 是**面积归一化**卷积核,ε=0 时中心值 2/π≈0.637,**不是**峰值 1;若画"相对剩余通量"就要除以 G(0) 或说明约定。
- - 与在线数据表对账(如 Takeda 2019 在线表 `g_transform_info.dat` 的零点/旁瓣数据),一致才算交叉验证。
- - 多版本数值并存时(同一量在不同教材/数据库取 2.0 / 1.9 km/s),要说明各自定义,不能混用。
- ### 2.6 抓取校验(治真实事故)
- **真实事故**:文献子代理下载 9 个"PDF",其中 5 个不是 PDF——3 个 14,371 B 的 ADS captcha HTML、2 个 `<!doctype html>`;另一个任务里 `_refs/ref-01.pdf` 是 0 字节。26 分钟大部分花在失败重试,HTML 落成 `.pdf` 污染工作区。
- 规则:
- 1. 下载后**先嗅探文件头再用**:`%PDF` 才算 PDF;0 字节直接删;HTML/captcha 换源。
- 2. bash 工具里可用的检查(toybox 语义,无 curl):
- ```bash
- head -c 8 _refs/paper.pdf | od -c | head -1 # 应见 % P D F
- wc -c _refs/paper.pdf # 0 字节 → 删
- grep -l -i -E "<!doctype|<html|<head|captcha" _refs/*.pdf 2>/dev/null # 混进 .pdf 的 HTML/captcha
- ```
- 实测:对任务目录里 9 个 `ref-*.pdf` 跑上面的 grep,命中 5 个(`ref-01.pdf`、`ref-02.pdf`、`ref-03.pdf`、`ref-04.pdf`、`ref-05.pdf`)——正好是复盘里"9 个下载 5 个不是 PDF"的 5 个;`head -c 8` 分别显示 `<!doctype ht` 与 `<head><title`。**所以 `%PDF` 嗅探 + HTML 关键字 grep 两个都要做**:只看大小或扩展名会漏。
- 3. `python` 工具更稳(一次查一批):
- ```python
- import pathlib
- for p in sorted(pathlib.Path("_refs").glob("*")):
- if p.is_file():
- head = p.open("rb").read(8)
- print(p.name, p.stat().st_size, head)
- ```
- 4. 换源顺序:出版社/期刊页面 → arXiv abs/pdf → 作者主页 → ADS 全文链接;每次抓取记 URL 与结果(成功/失败原因)。
- 5. 抓不到不要猜:标「未找到」,换源或写进未核实清单。**不要把"换个网站也没找到"写成"已核实"**。
- ### 2.7 DOI / arXiv 校验
- - DOI:用 Crossref API(`https://api.crossref.org/works/<doi>`)或出版社页面核对标题/作者/年份/卷/页;解析失败说明 DOI 或条目有问题。
- - arXiv:用 `https://arxiv.org/abs/<id>` 核对标题/作者/日期;注意 v1/v2 版本差异(结论可能不同,写清版本)。
- - 数据库书目(ADS/SIMBAD)适合查卷页与 DOI,但**已知文献的经典公式仍然要回到原文或权威教材核对**。
- ## 3. 文本质量核查(本次新增重点)
- 顺序固定:**先术语(3.1)→ 再逻辑(3.2)→ 最后文风(3.3)**。术语错会带出逻辑错;文风最后改,避免文风修改掩盖事实问题。
- ### 3.1 不合适的自造词
- **类型表**
- | 类型 | 例 | 问题 |
- |---|---|---|
- | 生造译名 | 推断链、中介软化、可错性后移 | 学科里没有这个词,读者无法对照标准概念 |
- | 中英混造 | 客观性 = 透明 + 收敛 | 用符号化简写冒充定义 |
- | 非标准缩写 | 四环、可审计清单 | 首次出现未定义,或与学科既有缩写冲突 |
- | 普通词硬造成术语 | 一条链,四个位置 | 文学比喻被当概念 |
- | 程度词冒充量 | 信息极贫乏、推断极富集 | "极"字无量化,无法检验 |
- **检查方法**
- 1. 对照学科标准术语表 / 教材 / 权威数据库(物理用教材与标准文献;哲学用原著与学科词典)。
- 2. 同一概念全文是否只有一个名字(grep 同义词组:如"推断链 / 推理链 / 推断路径")。
- 3. 首次出现是否有定义 + 英文对照;缩写是否展开。
- 4. 是否与已有标准术语冲突或重叠。
- 5. 自造词是否暗含了没论证的结论(如"可错性后移"暗含时间顺序)。
- **真实案例**(一份课程汇报 PPT 文案 v1→v2 的术语校订,全部为实际发生)
- | 旧表述 | 问题 | 建议改为 |
- |---|---|---|
- | 推断链 / 推断极富集 / 信息极贫乏 | 生造;程度词冒充量 | 观测—定标—反演链条;观测信息有限、推断环节长 |
- | 中介软化 | 生造 | 中介的抽象程度递增(物质性中介 → 观念性中介) |
- | 可错性后移 | 生造(暗含时间顺序) | 错误暴露的难度递增 |
- | 因果互换 | 不合规范表述 | 原因与结果的相互转化 |
- | 一条链,四个位置 | 文学化 | 科学技术体系的四个环节 |
- | 可审计清单 | 生造 | 可复核要求 |
- | 客观性 = 透明 + 收敛 | 符号化简写 | 客观性来自观测链条的透明与独立证据的收敛 |
- | 我做什么 / 中介在哪 / 何时会错 | 口语化设问 | 环节功能 / 中介性质 / 失效条件 |
- **术语一致性表模板**
- | 概念 | 全文出现写法 | 标准表述 | 首次定义位置 | 处理 |
- |---|---|---|---|---|
- | 观测到推断的过程 | 推断链、推断路径 | 观测—定标—反演链条 | §2 第 3 段 | 全改,保留英文 chain of observation–calibration–inversion |
- | 错误暴露难度 | 可错性后移 | 错误暴露的难度递增 | §4 | 全改 |
- **处理原则**
- - **能用原文原词就用原文原词**(用户明确要求"用词尽量用原文,不要 AI 味");作者自造词若必须保留,要"首次定义 + 全文一致 + 英文对照 + 说明与标准术语的关系"。
- - 不静默替换:报告里列"旧 → 新"对照表,供作者逐条否决(真实做法见 v2 文首的「术语校订表」)。
- - P1 级别:术语混淆会直接导致概念错误;不要放进"文风问题"降级处理。
- ### 3.2 不合逻辑的结论
- **检查清单(逐条问,不跳)**
- | # | 检查项 | 判断问题 |
- |---|---|---|
- | 1 | 因果倒置 | 是 A 导致 B、B 导致 A,还是共同原因 C? |
- | 2 | 以偏概全 | 样本/条件能支撑到全文范围吗?特例被当成通例? |
- | 3 | 循环论证 | 结论是否已被当作前提使用? |
- | 4 | 类推不当 | 比喻/类比是否有结构对应,还是只共享一个词? |
- | 5 | 数据不支撑结论 | 给出的数字能推出该结论吗?有没有反例? |
- | 6 | 量级/单位/精度 | 单位一致吗?有效数字超出数据精度吗?数量级对吗? |
- | 7 | 绝对化表述 | "必然/所有/完全/证明"有依据吗? |
- | 8 | 概念偷换 | 同一词在不同段落含义变了吗(v sin i vs v;相关 vs 因果)? |
- | 9 | 相关当因果 | 统计相关被写成机制/因果? |
- | 10 | 样本/条件缺失 | N、选择效应、观测条件、隐含假设写出来了吗? |
- **输出格式**:位置 / 原句 / 前提→结论复述 / 断点 / 严重度 / 建议。
- **真实示例**
- | 原句 | 前提→结论 | 断点 | 建议 |
- |---|---|---|---|
- | 「晚期 A 型和早期 F 型恒星旋转速度几乎降至约 1 km/s」 | 前提:Am/Fm 化学特殊星自转慢 → 结论:所有晚 A/早 F 星都慢 | 以偏概全;且 v sin i 是投影值 | 改为"Am/Fm 星显著慢(约 10–30 km/s,个别更低);正常 A7–F0 主序星仍有几十 km/s;v sin i 是投影值" |
- | 「FWHM = 2Δλ_L」 | 前提:所见宽度即 2 倍半宽 → 结论:可直接由 FWHM 得 v sin i | 数值不支撑(实际 1.73/1.56 Δλ_L,高估 15%–28%) | 按 ε 给出系数并说明范围 |
- | 「v sin i 就是恒星自转速度」 | 前提:测得的线宽对应速度 → 结论:这就是自转速度 | 概念偷换(投影值 vs 真值,i 未知) | 每次写"投影自转速度 v sin i";讲平均值时说明随机取向假设 |
- ### 3.3 AI 味语句
- **特征清单(命中后逐条判断,不是见到就删)**
- 1. 模板化开头/结尾:「在当今快速发展的…背景下」「综上所述,…具有重要指导意义」。
- 2. 套路连接词堆砌:「值得注意的是」「不仅如此」「与此同时」「首先…其次…最后」。
- 3. 空泛形容词/副词:「极大地」「深刻地」「显著地」「有效地」「全方位」。
- 4. 同义反复:「首先,…;也就是说,…;换言之,…」。
- 5. 无信息过渡句:「下面我们来看…」「接下来我将从三个方面展开」。
- 6. 过度排比/三段式:「它既是…又是…更是…」。
- 7. 伪深刻总结/强行拔高:「这不仅是一个技术问题,更是一个哲学问题」。
- 8. 元话语:「这不是比喻」「需要强调的是」「不可否认」。
- 9. 设问式推进:「那么,为什么…?答案在于…」(真需要引导读者时才用)。
- 10. 每段强行升华/口号化:「让我们…」「共同…」。
- **改写原则(用户明确要求:保留原意、用词尽量用原文)**
- - 只做"减"与"换":删模板句/空话;抽象 → 具体、口号 → 事实、口语 → 书面。**不做"加"**,不引入没有信息量的句子。
- - 作者原话、学科名词、数据、引文优先保留;能用原文词就不用同义词。
- - 正式论文里个别"综上所述"可接受,连续堆砌才算问题;文风问题一般 P2,不上升为 P0。
- **前后对照改写示例(至少 3 组;前两组为真实修订)**
- **组 1|抒情化 + 元话语**
- - 原:「请老师跟着这条链,看科学技术的方法论是怎样在每一环里长出来的。」
- - 改:「本次汇报以这一技术过程为线索,考察科学技术的方法论问题,并回答任务书提出的问题。」
- - 改动说明:删"请老师跟着"的表演感与"长出来"的比喻;信息不变,废话减少。
- **组 2|断言式排比 + 口语推进**
- - 原:「先看总图。这个流程不是比喻。每一级处理确实由这四级技术栈支撑:……全篇只论证一个判断:四个环节不是四个方向,是同一条技术链的四个环节。链条上每一环都在加东西,而且中介由硬变软。」
- - 改:「现代观测活动可以分解为四个技术环节。自然界首先被器件转换为电信号,……这一分解有客观依据:四个环节之间是输入输出关系,后一环节的输入即前一环节的输出。四个环节的中介性质并不相同:……(逐项给定义)」
- - 改动说明:删元话语与"不是…是…"排比;把"由硬变软"换成可检验的"中介的抽象程度递增",并补出依据。
- **组 3|模板开头 + 空泛形容词 + 伪总结**
- - 原:「在当今快速发展的科技背景下,XX 技术越来越受到人们的广泛关注。值得注意的是,它不仅显著提升了效率,而且深刻地改变了人们的生活方式。综上所述,XX 技术具有重要的理论意义和广阔的应用前景。」
- - 改:「XX 技术把某项任务的耗时从 A 降到 B(数据来源),已用于 X、Y 两类场景。代价是 Z;在 W 条件下不适用。」
- - 改动说明:模板开头、空泛形容词、"综上所述"伪总结全部删除,换成可核数据、适用条件与代价。信息量从 ≈0 变成可检验。
- **组 4|同义反复 + 无信息过渡**
- - 原:「需要强调的是,这一点非常重要。换言之,它意味着我们必须高度重视该问题。接下来,我将从以下三个方面展开论述。」
- - 改:「这一点决定实验成败:……(直接给理由与做法)」
- - 改动说明:三句元话语合并成一句实质陈述;删过渡句。
- **组 5|口号化**
- - 原:「让我们携手共进,以创新驱动发展,为行业赋能,共同开创更加美好的未来。」
- - 改:删除;或换成具体行动与目标(谁、在什么时间、做什么、验收标准)。
- - 改动说明:纯口号,无信息;正式材料里出现应整句删除。
- **grep 自检(在稿件上跑,命中不等于错,逐条判断)**
- ```bash
- grep -n -E "值得注意的是|综上所述|总而言之|毋庸置疑|极大地|深刻地|显著地|有效地|不仅.*而且|首先.*其次.*最后|让我们|赋能|维度|范式|底层逻辑|的重要原因之一" 稿件.md
- ```
- ## 4. 报告格式与严重度
- ### 4.1 报告头(必须写)
- ```text
- 核查日期:YYYY-MM-DD
- 核查对象:<文件绝对路径>(范围:哪几节/哪几页)
- 核查方式:web_search / web_fetch 查阅作者官网、出版社、期刊页面、NASA ADS/SIMBAD、arXiv;Python 独立数值验证
- 覆盖范围:N 类、N 条
- 未读原文声明:凡未直接读到原文的条目,均标「存疑」
- ```
- ### 4.2 两张表
- **表 A 条目核查表**:编号 / 条目 / 结论档(已核实·存疑·未找到)/ 依据(等级 + 来源)/ 出处(字段见 §2.1)。
- **表 B 问题表**:位置 / 原句 / 类型(事实错误·自造词·逻辑·AI 味)/ 严重度 / 建议改法。
- ### 4.3 严重度分级
- | 级别 | 含义 | 例子 | 处置 |
- |---|---|---|---|
- | **P0** 事实错误 | 编造文献、公式错、数值/单位错、结论与数据相反 | DOI 造假;FWHM 系数写错导致 v sin i 高估 28% | 必改,交付前清零 |
- | **P1** 逻辑/术语 | 以偏概全、概念偷换、自造词混淆、出处错误 | 把并列关系当作论证;作者顺序写错(Smith & Gray 写成 Gray 1976) | 建议改,解释理由 |
- | **P2** 文风 | AI 味、空话、口语、排比堆砌 | 三段式开头、口号结尾 | 可选改,给改写示例 |
- ### 4.4 报告骨架(复制)
- ```markdown
- # <主题> 文献/公式核查报告
- 核查日期:YYYY-MM-DD。核查方式:……。凡未直接读到原文的,均标注「存疑」。
- ## 1. <条目类:公式>
- **【结论】已核实 / 存疑 / 未找到(写明核到什么程度)**
- **【公式】** ……
- **【出处】** 作者 年份 书名 版次 章 式号 页码 ISBN/DOI
- **【教学提醒】** ……
- ## 2. <条目类:数值>
- ……
- ## N. 疑似常见教材简化 / 失准说法清单
- 1. 原说法 → 问题 → 建议表述
- ## 主要参考文献(汇总,逐条带 DOI/arXiv/ISBN)
- ```
- (真实产物:`<工作目录>/文献核查报告.md`,10 类条目 + 教材简化清单 + 参考文献汇总。)
- ### 4.5 交付
- - 报告存任务目录:`<主题>_文献核查报告.md`;md 正文里不重复报告全文,只留引用。
- - "未核实/存疑"清单直接进 `course-material` §6 交付清单的"未验证项"。
- - 给主会话只回四行(结论/产出/风险未决/下一步建议),不贴全文。
- ## 5. 与其它 skill 的联动
- | 场景 | 怎么联动 |
- |---|---|
- | `course-material` §4 科研文献 → 教学材料 | **先跑本 skill §1–§2** 核查关键论断,再写材料;材料交付前跑 §3 三类文本质检 |
- | 讲义/论文的原文核对 | 用 `ohos-doc-read` 读原文(PDF/PPTX/扫描页),不要凭记忆引页码 |
- | docx 交付 | 排版/引用格式/图题中英双语归 `md2docx`;本 skill 给出处字段,两者对齐 GB/T 7714 或期刊简式 |
- | 图与图注 | 图用 `scifig`(轴标题带物理量与单位);本 skill 校图注单位、数值、来源标注 |
- | 组会/课程 PPT | 内容与引用表定稿后由 `make-ppt` 排版;引用页、图注按本 skill 的出处字段写 |
- | 条目多(>20 条)要并行 | 按 `agent-teams` 拆条目派子代理:每人只交条目表 + 证据(URL/文件头/计算),不贴原文全文 |
- | 学术论文写作 | 本 skill 当审稿器:先核事实与引用,再给逻辑/术语/文风意见;不代替作者定稿 |
- ## 6. 快速自检(交付前 30 秒)
- 1. 每条都有结论档?写"已核实"的确实读到了原文/权威数据库吗?
- 2. 每条都有出处字段?DOI 能解析、arXiv 编号存在吗?
- 3. 抓取的文件都嗅探过文件头吗?有没有 0 字节或 HTML 冒充 PDF?
- 4. 自造词、逻辑、AI 味三类都过了一遍吗?改写示例是"减/换"而不是"加"吗?
- 5. "未核实/存疑"清单交给用户了吗?
- 6. 报告里有没有把"存疑"美化成"已核实"?(禁止美化,这是本 skill 的底线)
README.md · README · 88 lines
- # literature-verify
- 文献、公式、数值与中文文稿质量核查 skill:**只给证据,不改稿**。
- 两件事共用一套骨架:
- 1. **事实核查**:文献书目 / 经典公式 / 数值常数 / 单位 / 出处(作者、年份、刊、卷、页、DOI/arXiv/ISBN);
- 2. **文本质量核查**:自造词、不合逻辑的结论、AI 味语句。
- 流程固定为:拆条目 → 逐条三档 → 填全出处字段 → 抓取校验(文件头嗅探)→ 出报告。
- ## 安装
- ### DSHM
- DSHM 的 `$DSH_HOME/skills/` 是**一个技能一个 `.md` 文件**(扁平目录):
- ```bash
- cp SKILL.md "$DSH_HOME/skills/literature-verify.md"
- ```
- 重开 DSHM(或新会话)后即可使用。
- ### Claude Code
- ```bash
- mkdir -p ~/.claude/skills/literature-verify
- cp SKILL.md ~/.claude/skills/literature-verify/SKILL.md
- ```
- 本 skill 是纯 Markdown 指令,核心动作是检索、读原文、独立重算与写报告,不依赖特定运行时。
- ## 适用场景
- - 核对论文 / 教材里的经典公式、数值、常数、定义,找出处;
- - 给讲义补引用、做文献综述前核实书目;
- - 查 DOI / arXiv 编号是否真实、卷页是否正确;
- - 审稿或自审中文文稿:查自造词、逻辑断点、AI 味;
- - 核查下载到的 PDF 是不是真的 PDF(HTML / captcha / 0 字节伪装)。
- **不做**:重写文章、代写文献综述、排版与公式渲染、替作者定稿。
- ## 核查三档
- 每条待核查内容都必须落到下面三档之一,并写清依据等级:
- | 结论档 | 含义 | 依据要求 |
- |---|---|---|
- | **已核实** | 直接读到原文或权威数据库,字段齐全 | 原文直读可 1 个来源;否则至少 2 个独立来源一致 |
- | **存疑** | 有线索但没读到原文,或来源冲突、版次/式号不确定 | 写清「核到什么程度」与冲突点 |
- | **未找到** | 检索后仍未定位到可靠出处 | 写进「未核实清单」,交给用户 |
- 依据等级(从高到低):**原文直读 > 权威数据库(出版社 / ADS / Crossref / arXiv)> 二手来源 > 独立推算**。
- 三条铁律:
- 1. 没读到原文 / 权威数据库,就标「存疑」或「未找到」,**绝不写「已核实」**;
- 2. 禁止编造文献、DOI、页码、式号——宁可少引,不可假引;
- 3. 教材的「简化」与「真错」分开:简化写清成立条件与误差,真错才进 P0。
- 报告同时给出严重度:**P0** 事实错误(必改)、**P1** 逻辑 / 术语(建议改)、**P2** 文风(可选改,附改写示例)。
- ## 依赖
- | 能力 | 说明 |
- |---|---|
- | 联网检索 / 抓取 | 任意可用的搜索与 HTTP 抓取工具(DSHM 内置 `web_search` / `web_fetch`,或其他等价工具) |
- | 读 PDF / PPTX 原文 | 可选。DSHM 可用 `ohos-doc-read`;其他环境用 `pdftotext`、PyMuPDF 等,**不要凭记忆引页码** |
- | 数值重算 | Python(必须独立重算,禁止心算、禁止抄中间结果) |
- | docx 交付 | 可选,`md2docx` 负责排版;本 skill 只给出处字段与核查结论 |
- ## 运行环境(DSHM / DSH)
- - **DSHM(鸿蒙端侧)**:DeepSeek Harness 的鸿蒙发行版,数据目录位于应用沙箱内,本文记为 `$DSH_HOME`。把本技能放到 `$DSH_HOME/skills/<name>.md`(单文件)或 `$DSH_HOME/skills/<name>/SKILL.md`(带 `refs/`、`scripts/` 等附属目录),新开会话后生效。
- - **DSH 桌面版(macOS / Windows / Linux)**:技能目录按对应版本文档(通常为 `~/.dsh/skills/`),结构与 DSHM 相同;区别只是 `$DSH_HOME` 不在鸿蒙应用沙箱内。
- - 两种环境的 `SKILL.md` 完全通用;**不要**把 DSHM 沙箱内的绝对路径写进配置或脚本,需要可移植路径时用环境变量。
- ## 版权、第三方依赖与商标
- - **本项目**:MIT,见 [LICENSE](LICENSE)。示例图、示例数据由本项目程序生成,随 MIT 许可发布。
- - **第三方依赖**:纯 Markdown 指令,无运行时依赖;核查时使用的检索/抓取工具由运行环境提供。
- - **字体与图片**:本仓库不含字体文件、不含第三方图片素材。
- - **商标与归属**:DSH、DSHM、DeepSeek Harness 是其各自所有者的产品名或商标;本项目是独立的第三方开源工具,与官方无隶属、赞助或背书关系。GitHub 为其所有者商标。
- - **代码来源**:本仓库代码为原创实现;如果后续引入第三方代码,会在此列出其来源与许可。
- ## 许可
- MIT,见 [LICENSE](LICENSE)。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.