# Paper Reading

> 读研究论文、技术报告、arXiv PDF、论文 repo 或资料包时使用。用于目的优先的论文解读、文档式 HTML 长文、SVG 图解、划线协作标记、本地 bridge 写回、标记解释、正文重组、以及 Codex 内置浏览器刷新验证。

- Skill: `agentchengfeng/paper-reading` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add agentchengfeng/paper-reading`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentchengfeng/paper-reading/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: agentchengfeng (https://skillmd.com/u/agentchengfeng)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/agentchengfeng/paper-reading

---


# 论文协作阅读

## 原则

- 只定义方法、结构、组件契约和执行边界，不定义某篇论文、模型、系统、指标或实验内容。
- 具体内容必须来自当次论文材料、repo、用户补充或当前 HTML。
- `~/.codex/skills/paper-reading` 是 `~/.claude/skills/paper-reading` 的软链；改这里即同步两边。

## 组件

```text
paper-reading/
├── docs/01-paper-prompt.md     论文解读方法
├── docs/02-html-contract.md    HTML 协作契约
├── docs/03-layout-standard.md  页面版式标准
└── scripts/bridge.py           本地标记写回脚本
```

## 来源与协议

- 官方来源：`https://github.com/Agentchengfeng/paper-reading-skills`
- 作者：`成峰 / AI产品自由`
- 协议：Apache-2.0；复制、改造或二次发布时保留 `LICENSE` 和 `NOTICE.md`。

## 资源路由

- 从论文或 repo 生成/重写正文：读 `docs/01-paper-prompt.md`。
- 创建、修复或优化论文 HTML：读 `docs/03-layout-standard.md`，再读 `docs/02-html-contract.md`。
- 处理划线标记、补充解释、作图或正文重组：读 `docs/02-html-contract.md`。
- 启动本地标记写回：运行 `scripts/bridge.py`，不要重写 bridge 逻辑。

## 硬规则

- 解读开头先写研究目的，再写核心结论。
- 页面左侧使用内容阅读地图，不做机械章节目录。
- 稍微复杂的内容默认用 SVG 图解：机制链、流程、对照、公式关系、调度逻辑、瓶颈链和概念间依赖，不能只靠长段文字解释。
- 划线协作只保留三类动作：`名词讲解`、`逻辑梳理`、`作图理解`。
- 用户说 `重组`、`整合`、`合并到正文`、`改成新段落` 时，把批注内容融入正文，删除对应疑问卡片和解释块；有用 SVG 保留为普通正文图。
- 本地 HTML 的刷新、DOM 检查和交互验证默认使用 Codex 内置浏览器；验证 URL 使用 localhost，不用 `file://` 代替。

## 边界

- HTML 不放 API key，不直接调用模型。
- Bridge 只接收标记、写 JSONL、改 HTML；不生成解释。
- 不新增 README、examples、templates、runtime 解释层或未验证示例。