Skip to content
Back to search

Spark-To-Paper-Skills

MarketplaceWorks with Claude CodeGitHub

Self-hosted marketplace for PaperJury, the pre-submission paper review and editing plugin for CS-conference papers.

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/spark-to-paper-skills-paperjury/badge.svg)](/listings/spark-to-paper-skills-paperjury)

HTML

<a href="/listings/spark-to-paper-skills-paperjury"><img src="/api/listings/spark-to-paper-skills-paperjury/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code plugin

推荐使用 marketplace 方式安装:

/plugin marketplace add Spark-To-Paper-Skills/paperjury
/plugin install paperjury@Spark-To-Paper-Skills

Clone 成 skill

也可以把仓库 clone 到 Claude Code 读取 skill 的目录:

# macOS / Linux
git clone https://github.com/Spark-To-Paper-Skills/paperjury ~/.claude/skills/paperjury
# Windows (PowerShell)
git clone https://github.com/Spark-To-Paper-Skills/paperjury "$env:USERPROFILE\.claude\skills\paperjury"

也可以放在 `<项目>/.claude/skills/` 目录下,仅对单个项目生效。

安装后建议进行以下检查:

- Claude Code 会通过 `SKILL.md` 自动发现该 skill,其名称为 `paperjury`。 - 需要安装 `node`,因为确定性检查运行在 Node 环境中。 - LaTeX 工具链是可选的;真实编译和版面检查会使用它,如果没有安装,会明确说明哪些检查无法执行。 - 在 skill 目录中运行 `npm run doctor`,可以检查仓库完整性、检查所需工具以及识别论文文件。 - 启动时会对 GitHub 稳定版 release tag 进行一次软更新检查;发现新版本时仅提示,不会阻塞当前工作。设置 `PAPERJURY_DISABLE_UPDATE_CHECK=1` 可以关闭提醒。更新后请开启新会话。

如何选择 Claude Code 版和 Codex 版

| 版本 | 入口 | 适合 | |---|---|---| | **Claude Code 版** | 本仓库;Claude Code plugin 或 `.claude/skills/` | 你主要在 Claude Code 中撰写论文、修改 LaTeX 文件或运行 workflow。 | | **Codex 版** | [paperjury-codex](https://github.com/Spark-To-Paper-Skills/paperjury-codex) | 你主要在 Codex 或 Codex plugin 环境中运行同一套评审和修订流程。 |

**给 Claude 或编码 agent:**更深入的驱动说明请参阅 [`docs/AGENT-GUIDE.md`](docs/AGENT-GUIDE.md)。其中包含安装方法、三种模式及其触发方式、引擎管线、`auto` 与 `/goal` 的区别,以及如何启动并行评审。

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.

.claude-plugin/marketplace.json · Manifest · 27 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "Spark-To-Paper-Skills",
  3. "owner": {
  4. "name": "Yiran Wang"
  5. },
  6. "description": "Self-hosted marketplace for PaperJury, the pre-submission paper review and editing plugin for CS-conference papers.",
  7. "plugins": [
  8. {
  9. "name": "paperjury",
  10. "source": "./",
  11. "description": "Pre-submission AI review and editing for CS-conference papers: direct-edit LaTeX or Markdown (Word via one-time extraction), run an adversarial multi-agent courtroom review with consensus-gated revisions, or run it unattended toward a goal.",
  12. "version": "1.2.1",
  13. "author": {
  14. "name": "Yiran Wang"
  15. },
  16. "homepage": "https://github.com/Spark-To-Paper-Skills/paperjury",
  17. "license": "MIT",
  18. "keywords": [
  19. "academic-writing",
  20. "peer-review",
  21. "adversarial-review",
  22. "latex",
  23. "paper-review"
  24. ]
  25. }
  26. ]
  27. }
README.md · README · 407 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="docs/paperjury-mark.png" width="170" alt="PaperJury logo">
  3. </p>
  4. <h1 align="center">PaperJury</h1>
  5. <h3 align="center">Due-Process Review for Bounded LaTeX Revision</h3>
  6. <p align="center">
  7. <b>正式投稿前,先让 AI reviewer 指出论文中需要解决的问题。</b><br>
  8. <b>模型负责阅读、判断和起草;状态管理、投票规则、补丁应用与停止条件由确定性代码控制。</b>
  9. </p>
  10. <p align="center">
  11. <a href="https://spark-to-paper-skills.github.io/paperjury/"><img alt="Website" src="https://img.shields.io/badge/Website-paperjury-b07d2a?logo=githubpages&logoColor=white"></a>
  12. <a href="https://arxiv.org/abs/2606.16322"><img alt="arXiv" src="https://img.shields.io/badge/arXiv-2606.16322-b31b1b?logo=arxiv&logoColor=white"></a>
  13. <a href="samples/dogfood/"><img alt="Dogfood sample" src="https://img.shields.io/badge/Sample-Dogfood-2f7d55"></a>
  14. <a href="https://github.com/Spark-To-Paper-Skills/paperjury/releases"><img alt="Releases" src="https://img.shields.io/badge/Releases-stable-3b3d47"></a>
  15. <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
  16. <a href="https://github.com/Spark-To-Paper-Skills/paperjury"><img alt="GitHub" src="https://img.shields.io/badge/GitHub-paperjury-181717?logo=github"></a>
  17. </p>
  18. <p align="center">
  19. <b>中文</b> · <a href="README.en.md">English</a>
  20. </p>
  21. <p align="center">
  22. <a href="https://spark-to-paper-skills.github.io/paperjury/?lang=zh">🏛️ 项目主页</a> ·
  23. <a href="https://spark-to-paper-skills.github.io/paperjury/overview.html?lang=zh">🧭 交互式总览</a> ·
  24. <a href="docs/showcase/SHOWCASE.md">🏆 Dogfood showcase</a> ·
  25. <a href="docs/AGENT-GUIDE.md">🧑‍✈️ Agent Guide</a> ·
  26. <a href="CITATION.bib">📌 BibTeX</a> ·
  27. <a href="https://github.com/Spark-To-Paper-Skills/paperjury-codex">💻 Codex 版</a>
  28. </p>
  29. <p align="center">
  30. <a href="https://spark-to-paper-skills.github.io/paperjury/?lang=zh">
  31. <picture>
  32. <source media="(prefers-color-scheme: dark)" srcset="docs/overview-card-dark.png">
  33. <source media="(prefers-color-scheme: light)" srcset="docs/overview-card-light.png">
  34. <img src="docs/overview-card.png" alt="PaperJury 项目主页" width="100%">
  35. </picture>
  36. </a>
  37. </p>
  38. ---
  39. <table>
  40. <tr>
  41. <td width="18%">
  42. <a href="docs/showcase/SHOWCASE.md"><img src="docs/paperjury-mark.png" width="120" alt="PaperJury dogfood showcase"></a>
  43. </td>
  44. <td valign="middle">
  45. <b>🏆 真实 Dogfood 样例</b><br><br>
  46. 展示了一篇真实草稿在 auto 模式下的一轮完整评审过程:仓库中提供了<b>修改前后的 PDF</b>,以及<b>经过人工核对的运行报告</b>。建议先查看样例,再决定是否使用此工具评审自己的论文。<br><br>
  47. <a href="docs/showcase/SHOWCASE.md"><img src="https://img.shields.io/badge/查看完整样例_→-Before_After_Report-d73a49?style=for-the-badge" alt="查看完整样例"></a>
  48. </td>
  49. </tr>
  50. </table>
  51. ---
  52. > [!IMPORTANT]
  53. > PaperJury 是投稿前的自查工具,**不能替代作者的科学判断,也不能替代 peer review**。它不能用来编造实验、伪造结果、添加没有证据支撑的 claim,或掩盖论文局限。遇到需要新实验、缺少证据、依赖作者私有知识或需要研究判断的问题,系统都会交回作者处理。
  54. ---
  55. ## ✨ News
  56. - 🎉 **RedNote(小红书)里程碑:** 相关分享已达到 **3 万次浏览**、**1.8k 次收藏**。感谢大家的转发和收藏,也感谢大家将 PaperJury 推荐给更多正在撰写和修改论文的朋友。
  57. - 📄 **2026-06-15:PaperJury 论文已发布到 arXiv。** arXiv 页面:[*PaperJury: Due-Process Review for Bounded LaTeX Revision*](https://arxiv.org/abs/2606.16322)(arXiv:2606.16322)。论文系统介绍了「审稿 → 裁定 → 修改 → 复查」引擎:哪些任务由确定性脚本处理,哪些判断交给语义 agent;有争议的问题如何进入审议;不同风险的修改采用哪些护栏。
  58. - 🔔 **2026-06-10:v1.0.0 发布。** 这是第一个稳定版,与 Codex 版 v1.0 对齐。新增软更新提醒:发现新的稳定 tag 时只提示,不打断当前工作。
  59. - 🚀 **2026-06-05:PaperJury 的 Codex 版已发布。** 入口在这里:[paperjury-codex](https://github.com/Spark-To-Paper-Skills/paperjury-codex)。
  60. - 🧪 **Dogfood sample 已加入。** 仓库提供一个紧凑的 [dogfood sample](samples/dogfood/):包括修改前后的 PDF,以及经过人工核对的运行报告。
  61. ## 📌 引用论文
  62. 如果 PaperJury 对你的研究或写作流程有帮助,可以引用这篇 arXiv 论文:
  63. ```bibtex
  64. @misc{wang2026paperjurydueprocessreviewbounded,
  65. title={PaperJury: Due-Process Review for Bounded LaTeX Revision},
  66. author={Yiran Wang and Ruixuan An and Biao Wu and Wenhao Wang},
  67. year={2026},
  68. eprint={2606.16322},
  69. archivePrefix={arXiv},
  70. primaryClass={cs.CL},
  71. url={https://arxiv.org/abs/2606.16322},
  72. }
  73. ```
  74. 同一条目也放在 [`CITATION.bib`](CITATION.bib)。
  75. ---
  76. ## ⚡ 两条命令完成安装
  77. 在 Claude Code 中安装:
  78. ```text
  79. /plugin marketplace add Spark-To-Paper-Skills/paperjury
  80. /plugin install paperjury@Spark-To-Paper-Skills
  81. ```
  82. 然后,在你的论文项目中直接说明需求:
  83. ```text
  84. 请审稿,重点检查实验是否足以支持 claim。
  85. ```
  86. 也可以使用更日常的表达:
  87. ```text
  88. 请把 introduction 这段改得更紧凑,但不要改变 claim。
  89. ```
  90. 无需记忆命令。PaperJury 会根据你的描述在 direct-edit 与 review 之间选择;auto 必须显式启用。在 direct-edit 和 review 模式下,补丁会先交给你确认;auto 模式则按事前授权策略应用安全修改,并将高风险修改交回作者。
  91. ---
  92. ## 📊 同一批论文、同一套评测口径
  93. 12 篇 held-out 论文(Vision、NLP、ML 各 4 篇)、四个 baseline、盲审专家审计([arXiv 2606.16322](https://arxiv.org/abs/2606.16322))。删除线标出的数值来自四个 baseline 中最强的 **LLM-as-judge 循环**:
  94. <table align="center">
  95. <tr>
  96. <td align="center"><sub><b>问题质量 · panel-relative F1 ↑</b></sub><br><s>0.519</s> → <b>0.656</b></td>
  97. <td align="center"><sub><b>审计精度 · P<sub>verified</sub> ↑</b></sub><br><s>0.663</s> → <b>0.847</b></td>
  98. <td align="center"><sub><b>不安全编辑率 · ESVR ↓</b></sub><br><s>0.110</s> → <b>0.025</b>(低 4.4×)</td>
  99. </tr>
  100. </table>
  101. | 方法 | F1 ↑ | Acc<sub>v</sub> ↑ | Acc<sub>r</sub> ↑ | ESVR ↓ | 轮数 K | 每篇小时 |
  102. |---|---:|---:|---:|---:|---:|---:|
  103. | Forward-only 重写器 | n/a | n/a | n/a | 0.240 | 1 | 0.31 |
  104. | LLM 批评器 | 0.446 | n/a | n/a | n/a | 1 | 0.51 |
  105. | LLM-as-judge 循环 | 0.519 | 0.681 | n/a | 0.110 | 3.33 ± 1.07(2/12 触顶) | 2.06 |
  106. | 朴素无界生成器 | 0.459 | n/a | n/a | n/a | 1 | 8.37 |
  107. | **PaperJury(本文)** | **0.656** | **0.887** | **0.913** | **0.025** | **3.08 ± 0.67(0/12)** | **2.47** |
  108. <sub>**F1**:相对专家问题清单的 macro F1;**Acc<sub>v</sub> / Acc<sub>r</sub>**:盲审专家对终局裁定 / 路由决定的一致率;**ESVR**:已应用编辑中违反安全的比例(须与编辑量合读:PaperJury 每篇 13.4 处 vs judge 循环 14.3 处);n/a 表示该方法没有这项能力。逐篇配对比较中,PaperJury 的 F1 在全部 12 篇上胜过每个会生成问题清单的 baseline。每篇成本为 2.47 小时、6.76M token(朴素生成器为 8.37 小时、31.4M token)。</sub>
  109. 三类裁定的盲审复核一致率分别为:invalid-drop **0.872**、valid-fixable **0.913**、author-required **0.860**。消融实验中,移除某个部件会让与其职责相关的指标恶化(移除护栏链 → ESVR +0.152;移除庭审 → 裁定一致率 −0.153)。完整表格、图和逐项解读见 [项目主页](https://spark-to-paper-skills.github.io/paperjury/?lang=zh) 和 [论文](https://arxiv.org/abs/2606.16322)。
  110. ---
  111. ## 🤔 先判断意见是否成立,再决定是否修改
  112. **PaperJury 以 Claude Code skill 的形式提供**,把投稿前自查组织成一套闭环:**审稿 → 裁定 → 修改 → 复查**。它不会直接接受所有 AI 反馈,而是让每条意见经过完整的评审流程,最终得到三种裁定之一:
  113. | 裁定 | 含义 |
  114. |---|---|
  115. | ✅ **valid-fixable(成立可修)** | 表达不清、claim 过强、结构不顺等文本问题;不需要补充实验,也不会偏离原意。系统会起草最小补丁,通过护栏检查后再应用。 |
  116. | 🧑‍💻 **author-required(交回作者)** | 缺少实验、ablation、数据或证据,必须由作者判断。系统会原样交回,不代替作者作出研究决策。 |
  117. | 🛑 **invalid-drop(不成立,驳回)** | AI reviewer 误读了论文,或者提出了不应采纳的修改意见。该意见会被驳回并记录在案。 |
  118. ## 🎯 适合谁
  119. | 你现在的情况 | 可以直接这样用 |
  120. |---|---|
  121. | **📝 刚写完初稿** | 让它像 reviewer 一样通读全文,找出最可能影响投稿的问题,并将致命问题与轻微修改分开。 |
  122. | **🔍 投稿前最后自查** | 让它检查 claim 是否表述过强、实验是否足以支持结论,以及是否存在明显的格式风险。 |
  123. | **✍️ 只想改一段话** | 直接说「把这段改紧凑一点,但不要改变 claim」,它会先起草补丁,等你确认后再应用;不会将一处小修改扩大为整篇重写。 |
  124. | **🔁 需要无人值守的多轮修订** | 明确授权 auto 模式;安全修改可以直接应用,高风险问题仍会交回作者决定。 |
  125. ## 📦 你会得到什么
  126. | 输出 | 内容 |
  127. |---|---|
  128. | **📋 问题清单** | 每条 reviewer-style 问题都会附带证据、位置、判断结果和当前状态;不会将大量意见直接写入正文。 |
  129. | **🧩 可审阅补丁** | 只有安全修复会进入最小补丁;高风险改动会暂时搁置,等待作者决定。 |
  130. | **🛠️ 复查报告** | 如果具备 LaTeX 工具链就进行真实编译;否则会明确说明哪些检查无法完成,不会虚报验证结果。 |
  131. | **🧪 真实样例** | [`samples/dogfood/`](samples/dogfood/) 里有修改前后 PDF 和人工核对过的运行报告。 |
  132. 它与一般写作工具的区别:
  133. | | 它做的事 |
  134. |---|---|
  135. | **⚖️ 对抗式评审** | N 位领域 reviewer 分别通读全文。系统按争议程度分流问题:机械性或轻微问题进入 polish,重大问题进入双方对审的庭审。5 人陪审团隔离审议;如果没有明显多数,通常会增加到 12 人;如果所有陪审员都因上下文不足而无法判断,则直接交回作者。代码按照法定人数和多数规则判定指控成立或不成立:不成立的问题进入 invalid-drop,升级后仍无明显多数则进入 author-required。对于已判定成立的问题,judge agent 再路由为 valid-fixable 或 author-required,并为 valid-fixable 设定 close_criterion。单纯按指令改写的工具无法作出这类判断。 |
  136. | **🔁 闭环复查** | 每一轮都只基于当前稿件独立复查;评审团看不到上一轮的 ledger,避免旧结论形成锚定。确定性书记官把各轮结果写入同一份 ledger,直到某一轮不再发现新问题。应用修改前,新的质疑者还会复查被驳回的问题,以减少误判。 |
  137. | **🛡️ 分级护栏** | 安全修复按风险级别接受冻结锚点、单段编辑上限以及锚点和跨节含义审计。在 direct-edit 和 review 模式下,每处修改都等待作者确认;在 auto 模式下,安全修改按事前授权策略自动应用,高风险修改进入待办队列并交回作者。 |
  138. | **🛠️ 真实编译与合规检查** | 系统在你的机器上运行 LaTeX 编译,并报告报错、未定义引用、overfull box 和页数;如果没有工具链,会明确降级为结构 lint。确定性的投稿合规检查覆盖匿名化泄漏、页边距改动、documentclass 漂移、缺少必备章节和超出页数限制等常见风险。 |
  139. ## 🧭 三种模式:direct-edit、review 与 auto
  140. | 模式 | 什么时候用 | 行为 | 人工确认 |
  141. |---|---|---|---|
  142. | **✍️ direct-edit**(常用) | 只想修改一处文字、caption、LaTeX 表达或段落结构。 | 不启动评审面板,直接用写作工具包起草补丁。 | 作者确认后再应用。 |
  143. | **🔎 review**(偶尔) | 想让它审稿、挑问题、进行 mock-review,或只审查某一节 / 某条 claim。 | 启动对抗式评审引擎,先判断问题是否成立,再决定是否修改。 | 每处改动逐一确认。 |
  144. | **🔁 auto**(无人值守) | 已配置 `mode: auto` 策略,并用 `/goal` 给出可验证目标,希望系统连续运行多轮。 | 先确认 `spine` 和评审分配,再按 bounded-aggressive + edit-safety 策略迭代。 | 先提供整体授权;高风险项仍交回作者。 |
  145. > [!WARNING]
  146. > **auto 策略和跨轮运行都必须明确启用。** `mode: auto` 决定每个候选修改是自动应用还是进入待办队列;`/goal` 负责跨轮继续运行。仅打开工具权限或只发送普通 prompt,都不会启动无人值守的多轮循环。详见 [`docs/AGENT-GUIDE.md`](docs/AGENT-GUIDE.md) §3。
  147. ## 🧪 查看一次完整运行,再决定是否使用
  148. 一篇真实的 21 页草稿、11 个预先埋入的缺陷、一轮完整的 auto 模式评审:152 条 reviewer 意见去重后得到 55 个问题——其中 **26 处安全应用、10 个交回作者、19 条驳回**;修改后的稿件编译为 0 error / 0 warning。
  149. [`samples/dogfood/`](samples/dogfood/)([`original_draft.pdf`](samples/dogfood/original_draft.pdf) · [`revised_draft.pdf`](samples/dogfood/revised_draft.pdf) · [运行报告](samples/dogfood/RUN_REPORT.zh-CN.md))
  150. 如果只想确认稿件不会先因格式问题被拒,可以说:
  151. ```text
  152. 请执行 submission-readiness / 合规检查。
  153. ```
  154. 它会进行确定性格式筛查,再结合编译驱动的版面检查。
  155. ## 🚀 安装
  156. ### Claude Code plugin
  157. 推荐使用 marketplace 方式安装:
  158. ```text
  159. /plugin marketplace add Spark-To-Paper-Skills/paperjury
  160. /plugin install paperjury@Spark-To-Paper-Skills
  161. ```
  162. ### Clone 成 skill
  163. 也可以把仓库 clone 到 Claude Code 读取 skill 的目录:
  164. ```bash
  165. # macOS / Linux
  166. git clone https://github.com/Spark-To-Paper-Skills/paperjury ~/.claude/skills/paperjury
  167. ```
  168. ```powershell
  169. # Windows (PowerShell)
  170. git clone https://github.com/Spark-To-Paper-Skills/paperjury "$env:USERPROFILE\.claude\skills\paperjury"
  171. ```
  172. 也可以放在 `<项目>/.claude/skills/` 目录下,仅对单个项目生效。
  173. 安装后建议进行以下检查:
  174. - Claude Code 会通过 `SKILL.md` 自动发现该 skill,其名称为 `paperjury`。
  175. - 需要安装 `node`,因为确定性检查运行在 Node 环境中。
  176. - LaTeX 工具链是可选的;真实编译和版面检查会使用它,如果没有安装,会明确说明哪些检查无法执行。
  177. - 在 skill 目录中运行 `npm run doctor`,可以检查仓库完整性、检查所需工具以及识别论文文件。
  178. - 启动时会对 GitHub 稳定版 release tag 进行一次软更新检查;发现新版本时仅提示,不会阻塞当前工作。设置 `PAPERJURY_DISABLE_UPDATE_CHECK=1` 可以关闭提醒。更新后请开启新会话。
  179. ### 如何选择 Claude Code 版和 Codex 版
  180. | 版本 | 入口 | 适合 |
  181. |---|---|---|
  182. | **Claude Code 版** | 本仓库;Claude Code plugin 或 `.claude/skills/` | 你主要在 Claude Code 中撰写论文、修改 LaTeX 文件或运行 workflow。 |
  183. | **Codex 版** | [paperjury-codex](https://github.com/Spark-To-Paper-Skills/paperjury-codex) | 你主要在 Codex 或 Codex plugin 环境中运行同一套评审和修订流程。 |
  184. **给 Claude 或编码 agent:**更深入的驱动说明请参阅 [`docs/AGENT-GUIDE.md`](docs/AGENT-GUIDE.md)。其中包含安装方法、三种模式及其触发方式、引擎管线、`auto` 与 `/goal` 的区别,以及如何启动并行评审。
  185. ## 常见问题
  186. > **PaperJury 能审阅 Word (.docx) 文件吗?**
  187. 能。PaperJury 会将 .docx 文件一次性转换为 Markdown,并明确告知你转换过程中保留了哪些内容、哪些内容无法转换,例如复杂表格和公式。随后,它会在这份 Markdown 工作副本上执行完整的多轮评审。原始 Word 文件不会被修改。评审结束后,你获得的是修订后的 Markdown 文件和逐条修改清单;是否合并回 Word 文件由你自己决定。你也可以先将论文导出为 `.md` 或 `.tex` 格式,再直接交给它。
  188. > **它会不会擅自修改我的论文?**
  189. 不会。在 direct-edit 和 review 模式下,补丁需要经过你的确认后才会应用。auto 模式也必须显式开启,并且会首先获得你对核心方向、修订范围和策略的整体授权。
  190. ## 深入了解
  191. 新用户可以先跳过这一节。如果你想了解机制、源码结构或 agent 驱动方式,可以从这里开始:
  192. | 你想了解 | 入口 |
  193. |---|---|
  194. | 结果与方法的可视化 | [项目主页](https://spark-to-paper-skills.github.io/paperjury/?lang=zh) · [交互式总览](https://spark-to-paper-skills.github.io/paperjury/overview.html?lang=zh) |
  195. | 真实运行效果 | [`samples/dogfood/RUN_REPORT.zh-CN.md`](samples/dogfood/RUN_REPORT.zh-CN.md) |
  196. | 如何驱动 Claude 或编码 agent | [`docs/AGENT-GUIDE.md`](docs/AGENT-GUIDE.md) |
  197. | 引擎设计细节 | [`docs/REVIEW_ENGINE_V3_DESIGN.md`](docs/REVIEW_ENGINE_V3_DESIGN.md) |
  198. | 完整协议和状态机 | [`references/review-engine-v3.md`](references/review-engine-v3.md) · [`references/ledger-schema.md`](references/ledger-schema.md) |
  199. <details>
  200. <summary><b>展开机制、架构和项目结构说明</b></summary>
  201. ### 引擎原理
  202. PaperJury 将审稿过程拆分为一套有边界的“庭审”流程:先由有限数量的 reviewer 找出问题,再将有争议的意见提交审议;编辑阶段根据风险设置防护栏,多轮评审结束时由确定性脚本判断是否收敛。
  203. ```text
  204. assign-reviewers → reading-check → coverage-auditor → merge
  205. → { trial ‖ polish } → recall-audit → drafter
  206. → { edit-audit | meaning-audit } → clerk
  207. ```
  208. 所有能用脚本检查的部分都放在 `scripts/` 目录中,由 orchestrator 在各个 workflow 之间调用;需要判断语义的问题,则交给相互隔离的 model agents 处理。
  209. <details>
  210. <summary><b>确定性步骤(完整清单)</b></summary>
  211. 1. **读稿分解**:把手稿(LaTeX 或 Markdown)切分为阅读单元、规范段落列表和稳定段落编号,防止问题锚点漂移。
  212. 2. **Word 提取**:把 .docx 一次性转换为 Markdown 工作副本,并说明保留了哪些内容、哪些内容可能无法转换;原始 Word 文件不会改动。
  213. 3. **核心声明**(仅 auto 模式):提取核心 claim,交给作者确认后冻结为配置。
  214. 4. **Ledger**:用机器可读的记录保存活跃问题,并在不同轮次和会话间延续。只要没有仍然阻塞的 major 问题,就视为工具侧完成;author-required 会进入人工待办,不算工具侧未完成。
  215. 5. **日志**:编辑历史只追加记录,便于回滚。
  216. 6. **补丁应用**:以原子方式应用修改并记录日志,必要时可以恢复。
  217. 7. **锚点追踪**:定位已冻结的核心 claim;上下文变化时,标出需要重新审计的部分。
  218. 8. **交叉引用检查**:编辑前检查改动关键词是否还出现在其他位置;如果出现,就标记为需要语义审计。
  219. 9. **段落重新对齐**:每轮结束后,重新对齐因编辑而移动的段落编号,避免问题失去锚点。
  220. 10. **编译检查**:尝试真实的 LaTeX 编译;无法编译时降级为结构检查,并明确说明哪些结果无法验证。
  221. 11. **提交合规检查**:用脚本筛查常见的提交格式风险。
  222. 12. **安装自检**:运行 `npm run doctor`,检查仓库完整性、所需工具和手稿识别功能。
  223. </details>
  224. <details>
  225. <summary><b>语义步骤(完整清单)</b></summary>
  226. 1. **评审员分配**:根据论文研究方向,分配 N 位领域 reviewer。
  227. 2. **完整阅读检查**:每位 holistic reviewer 通读全文一遍,列出弱点、原文引文、总体置信度和按节覆盖情况;无法提供原文引文,就视为没有充分阅读。
  228. 3. **覆盖审计**:检查哪些 reviewer / section 组合可能存在略读。
  229. 4. **去重**:合并重复评论,并整理重要性、问题类型和交叉确认情况。
  230. 5. **审议(trial)**:有争议的问题进入庭审。先由 5 人审议,必要时增加到 12 人;法官把成立的问题判定为 `valid-fixable` 或 `author-required`。
  231. 6. **润色**:快速路径处理机械性问题和轻微问题;如果判断不稳定,就升级回审议。
  232. 7. **召回审计(recall)**:找回被误判为不成立的问题,并在应用修改前抽查强共识 major,防止集体误判。
  233. 8. **编辑起草**:对确认可修的问题起草最小改动。
  234. 9. **编辑审计 / 含义审计**:检查高风险改动、跨节一致性、冻结锚点和论证链条。
  235. 10. **书记官**:汇总本轮结果,合并重复项,整理残留问题,并用确定性规则判断是否收敛。
  236. 也支持简化的 3 人评审小组,作为快速路径。
  237. </details>
  238. <details>
  239. <summary><b>三个核心组成:Skill + Workflow + Memory</b></summary>
  240. 1. **Skill(入口 + 方法论)**:定义协议、reviewer 分配、共识检查、写作工具包和人工确认规则。详见 `references/review-engine-v3.md`、`references/reviewer-personas.md`、`references/writing-toolkit.md`。
  241. 2. **Workflow(并行评审引擎)**:语义步骤以 Workflow 运行,并行生成结果,再执行 schema 校验。Workflow sandbox 不能直接访问文件系统,因此确定性检查由 orchestrator 在各个 workflow 之间调用。
  242. 3. **Memory(持久状态 + 项目约定)**:`LEDGER.json` 是机器可读的主记录,`LEDGER.md` 是面向用户的版本;Claude memory 保存下次会话需要沿用的稳定约定,例如 house style、venue 和 reviewer persona 调校。
  243. Reviewer panel 由 N 位领域 reviewer 组成(默认 3 位,范围 2-4 位),运行时按论文 subfield 分配。所有 reviewer 共享同一套资深 reviewer 的基本要求:严格、精确、具有建设性;能够区分致命缺陷和可修复的小问题,也能跨 section 推理。某个 reviewer 无法确认时,就退回通用 reviewer;单个失败不会影响整个 panel。
  244. </details>
  245. <details>
  246. <summary><b>六条硬规则</b></summary>
  247. 1. **未经作者授权,绝不修改手稿。** direct-edit 和 review 模式逐处确认;auto 模式通过事前策略授权,并把高风险修改交回作者。
  248. 2. **评审者 / 陪审员相互隔离。**
  249. 3. **每条可修复问题都有明确修复标准。**
  250. 4. **不把内部记录写入被审文本。** 评审日志、修订记录和内部检查结论都只用于辅助作者,不会进入论文或冻结快照。
  251. 5. **分歧先讨论;无法达成一致时由作者决定,并记录原因。**
  252. 6. **所有路径和文件配置都在运行时解析,不硬编码。**
  253. </details>
  254. ## 架构与隐私
  255. - Workflow sandbox 没有文件系统,也不能启动子进程;所以所有确定性检查都由 orchestrator 在 workflow 之间调用。
  256. - `compile-guard.js` 不会假装验证过:无法真正编译时,就退到结构 lint,并报告 `compiled:null`。
  257. - 提交就绪检查分两部分:A = `compliance-check.js` + 一个语义 agent;B = 复用 `compile-guard.js` 的编译检查,再让模型读取 PDF 做版面复查。
  258. > [!NOTE]
  259. > 你的项目文件、ledger、journal 和 patch 都留在本地论文项目里。PaperJury 自己没有后端或服务器,也就不会把文件上传到 PaperJury 服务器。审稿走的是你自己的 Claude Code session;模型本身仍可能跑在云端,内容如何被处理取决于这套 Claude Code 环境的条款和设置,PaperJury 不会再额外加一层。
  260. ## 项目结构
  261. | 路径 | 作用 |
  262. |---|---|
  263. | `.claude-plugin/` | Claude Code marketplace 打包配置。 |
  264. | `workflows/` | 语义阶段:评审分配、覆盖检查、合并、庭审、召回审计、起草和收敛。 |
  265. | `scripts/` | 确定性检查脚本:ledger、journal、apply-patch、anchor-diff、cross-ref、compile-guard、doctor 等。 |
  266. | `references/` | 引擎协议、ledger schema、评审者人格、写作工具和方法论。 |
  267. | `docs/` | 项目主页、交互式总览、设计说明、arXiv 论文 PDF 和 agent 驱动指南。 |
  268. | `samples/dogfood/` | 真实草稿的 before/after PDF 和人工核对过的运行报告。 |
  269. | `tests/` | 确定性脚本和核心状态机测试。 |
  270. </details>
  271. ## Roadmap
  272. - [x] **软更新提醒。** 启动时检查有没有更新的稳定版 tag,有就给一条非阻塞提示。
  273. - [ ] **快速版本 / quick mode。** 更快、更省 token 的检查路径;不追求完整庭审深度,先给一轮可用的快速 triage。
  274. - [ ] **按不同会议的审稿口味调整 reviewer persona。** CVPR、ACL、NeurIPS 的 reviewer 关注点并不一样;目标是让评审更贴近各自社区的预期。
  275. - [ ] **基于视觉的版面校验。** 编译、渲染、再检查版面,不只看编译日志。
  276. - [ ] **从 `.cls` / 模板自动识别 venue。**
  277. - [ ] **用更多真实论文做规模化验证。**
  278. <details>
  279. <summary><b>更多文件与路径</b></summary>
  280. - 引擎协议:`references/review-engine-v3.md`
  281. - 自动模式:`references/auto-mode.md`
  282. - 评审者角色、编辑工具、方法论:`references/reviewer-personas.md`、`references/writing-toolkit.md`、`references/methodology.md`
  283. - 账本结构和状态:`references/ledger-schema.md`
  284. - 提交合规:`references/submission-compliance.md`
  285. - 设计说明:`docs/REVIEW_ENGINE_V3_DESIGN.md`
  286. - 脚本:`scripts/`(`decompose`、`extract-docx`、`ledger`、`journal`、`apply-patch`、`anchor-diff`、`cross-ref`、`spine`、`rekey`、`compile-guard`、`compliance-check`、`doctor`)
  287. - 步骤:`workflows/`(`assign-reviewers`、`reading-check`、`coverage-auditor`、`merge`、`trial`、`polish`、`recall-audit`、`drafter`、`edit-audit`、`meaning-audit`、`clerk`、`review-panel`)
  288. </details>
  289. **了解更多:** [`docs/AGENT-GUIDE.md`](docs/AGENT-GUIDE.md)(驱动指南)· [`docs/REVIEW_ENGINE_V3_DESIGN.md`](docs/REVIEW_ENGINE_V3_DESIGN.md)(设计说明)· [项目主页](https://spark-to-paper-skills.github.io/paperjury/?lang=zh)
  290. ## 致谢
  291. PaperJury 的 spine 和防漂移设计受 [PaperSpine](https://github.com/WUBING2023/PaperSpine) 启发,尤其是 anchor logic-transfer audit、claim register、minimal-edit 且保持原意的改写策略。PaperSpine 更偏 motivation-driven 的论文起草和改写;PaperJury 借用了其中的 anchoring 思路,以及「可检查步骤交给确定性脚本、判断交给 model agent」的分工,再在此基础上加入对抗式 review 和庭审式裁定流程。
  292. ---
  293. ## Star History
  294. [![GitHub stars](https://img.shields.io/github/stars/Spark-To-Paper-Skills/paperjury?style=for-the-badge&logo=github&color=f5c542&label=GitHub%20Stars)](https://www.star-history.com/#Spark-To-Paper-Skills/paperjury&Date)
  295. <sub>星标曲线暂停:GitHub 限制了第三方获取 stargazer 数据;仓库装上 [star-history GitHub App](https://star-history.com/blog/github-stargazer-api-restriction) 后自动恢复。</sub>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.