关于 nature-reader
nature-reader 是将研究论文制作为 Markdown 阅读材料或译文的技能,支持多种来源格式,并通过来源映射和术语表保持内容有据可查且术语一致。
主要功能
- 01PDF、HTML、DOI 与粘贴文本流程
- 02先建来源映射的阅读流程
- 03双语阅读材料
- 04重复术语表
- 05图表与公式处理指南
适用场景
- 01将论文制作为 Markdown 阅读材料
- 02翻译整篇论文
- 03提取并翻译指定段落
- 04回答带来源依据的论文问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ yuan1z0825/ nature-skills --skill nature-reader安装后在 Claude Code 中输入/nature-reader确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
manifest.yamlREADME_EN.mdREADME.mdagents/openai.yamlevals/evals.jsonreferences/article-anatomy.mdequation-handling.mdfigure-extraction.mdgrounding-rules.mdoutput-spec.mdscripts/validate_reader_math.pystatic/core/output-contract.mdprinciples.mdworkflow.mdstatic/fragments/source/doi-arxiv.mdhtml.mdpasted-text.mdpdf-text.mdscanned-pdf.md详细介绍
全文 Markdown 阅读器 — 路由
路由协议
首先区分是创建阅读器,还是回答问题或翻译摘录。
对于带来源链接的问题,阅读 references/grounding-rules.md,并仅检查相关的
来源材料;在可用时复用已有的 source-map ID。不要重新生成阅读器,也不要
在回答前要求完整的 source map。对于明确的摘录请求,对该摘录应用提取、
翻译和依据规则。下方的完整工件工作流适用于用户请求阅读器或全文翻译时。
对于新任务,加载下方的核心资源和匹配资源。在后续追问中复用已加载的指引;仅在任务需要时加载更多内容。
1. 加载清单和核心层
阅读 manifest.yaml。它声明了 source_format 轴、允许的值,以及每个值映射到的文件路径。
同时阅读 always_load 下列出的每个文件。这些文件包含适用于每个阅读任务的核心原则、阅读工作流和输出契约,以及用于构建重复术语表的共享 Terminology Ledger。
2. 检测来源格式
根据清单的 detect: 提示和用户输入,确定 source_format 的值:
pdf-text— 可选文本 PDF。默认值。scanned-pdf— 仅图像或需要 OCR 的 PDF。html— 出版商或预印本 HTML 页面。doi-arxiv— 必须先解析的裸 DOI 或 arXiv 链接。pasted-text— 粘贴的正文或笔记,无可检索的原始排版。
在处理前用一行简短说明向用户告知检测到的值,以便他们能以低成本纠正你。一个来源可能映射到多个值(例如解析为 PDF 的 DOI);先加载解析片段,再加载解析后工件的片段。
3. 加载匹配的片段
阅读为检测到的 source_format 映射的文件。不要阅读 static/ 中的每个片段。仅加载步骤 2 所选的内容。
4. 使用已加载的材料构建阅读器
按以下优先级顺序应用已加载的片段:
- 核心原则(
core/principles.md)— 默认双语阅读器,按含义翻译,绝不降级为摘要,版权注意事项。 - 来源格式片段 — 如何为此输入提取文本、图表和表格。
- 阅读工作流(
core/workflow.md)— 六步 source-map 优先流程。 - 输出契约(
core/output-contract.md)— 必需文件以及响应前验证清单。
在翻译时构建 Terminology Ledger(../nature-shared/core/terminology-ledger.md);它将成为 paper.md 的重复术语表和 source_map.json 的术语表。
如果约束条件妨碍完整处理,仍要创建阅读器草稿,并在 translation_notes.md 中标注缺失的页面、图表或低置信度的裁剪。不要切换到摘要模式。
5. 仅在需要时查阅参考
references/ 下的文件是深度参考,而非默认项。根据清单中的 references.on_demand 表按需打开它们:
- 详细的图表裁剪和放置 →
references/figure-extraction.md。 paper.md/source_map.json的确切字段模式 →references/output-spec.md。- 方程、数学表达式、化学式或仅图像形式的公式 →
references/equation-handling.md。 - 使用来源引用回答追问 →
references/grounding-rules.md。