SuperAPI AI 工具集

paper-reviewer

写作与研究

查看项目

更新于 10-15 17:28

技能介绍

该技能从审稿人一侧处理稿件,将审稿报告与作者回复视为同一能力的两面:只有能复现问题,才谈得上证明已经回答。使用前先选择模式。report 模式输入稿件,输出审稿报告或预测审稿人会攻击的点;inventory 模式输入一份审稿报告,按审稿人原文用词和原有顺序列出每条要求与子要求;reply 模式输入报告与稿件,为每条要求给出一条回复并附覆盖审计;grade 模式输入草拟回复,给出急躁审稿人会如何回击。

核心约定是让两份清单逐条对齐:数量相同、标识相同、顺序相同、用词相同,深度与分量匹配。对齐必须在页面上可见,而非靠概述断言。审稿人评论须逐字完整重现于其回复正上方,不转述、不概括、不删减;回复沿用审稿人自己的用词,不另造术语或框架名;首句即给出答案,长度以说清问题为限,过度回答轻量意见与回答不足同样算缺陷。

拆分要求的原则是一句话:凡满足该条需要不同动作处即拆分。同一动作可同时了结的两个从句才算一条要求。遇到审稿人给出的枚举项、请求动词、疑问句、把缺陷断言为事实的句子、不同目标对象和不同交付物均需拆分;减去统领下文的引导句、换词重申的请求和仅为请求辩护的句子。编号沿用审稿人的,不重编、不重排、不按主题重组,保留空缺(如只评了 a)、c),则不做 b)),引用内的笔误照留。若审稿人未编号,按其分段拆分,用 R1-P1 这类明显由作者添加的标签,并说明一次。台账记入 notes/review-ledger.md,仅作工作产物,不进入回复信。

回复块结构为:审稿人原评论、答案句、证据(篇幅允许时)、位置。两类刻度:科学风险的严重度决定工作量,审稿人自身的措辞分量决定回复字数上限,轻量小意见约 40 词,编号实质意见约 120 词,对有效性、对照、统计或核心主张的异议约 300 词;两者冲突时多做工作、回复仍保持简短。语言上首句不超过 25 词且用审稿人自己的名词,不重命名其术语,未用过的术语首次出现给 6 词以内白话注解,致谢不超过一个从句,每个数字带数值、单位或指标、优劣方向和比较对象,一句一个想法、不超过 30 词、一个模糊词,不用破折号,先说不受欢迎的事实,不以"正如审稿人所指出的"等填充语开头,每条回复结尾必须有位置或明确说明未改动及原因。

grade 模式的检查包括两行测试、计数检查、荧光笔检查和落地检查;机械部分可运行检查脚本: python3 ~/.agents/skills/paper-reviewer/scripts/check_coverage.py \ --reviewer reviews/round1.txt --letter response/round1.md \ [--ledger notes/review-ledger.md] [--manuscript manuscript.md] [--strict] [--json] Claude Code 全局安装时把 ~/.agents/skills 换成 ~/.claude/skills,项目内安装换成 .claude/skills。脚本不能判断回复是否切题,跑通不等于信写得好。

相关文件:review_checklist.md(撰写报告或预测攻击点)、comment_splitting.md(生成清单或跨轮沿用)、reply_blocks.md(起草或评分单条回复)、common_issues.md(命名方法或统计问题、分类收到意见)、reporting_standards.md(涉及指南、检查表或 Reporting Summary)、scripts/check_coverage.py(发送前的机械覆盖审计)。该技能不负责的部分:rebuttal-response 决定说什么(立场、证据支撑的最强主张、负面结果处理及正文与补充材料一致性),submission-audit 对未审稿件做一次审稿式拒稿检查,stats-reporting-audit 负责统计实质(n 的独立单位、重复、多重比较校正、图注统计),nature-portfolio-playbook 负责期刊与文章类型选择;本技能假定期刊已定。Nature Portfolio 说明:自 2025 年 6 月起 Nature 对新研究投稿公开审稿报告与作者回复,Nature Communications 自 2022 年 11 月起,其他刊各异,有的需选择加入;除非查过具体期刊页面确认,应假定回复会被公开,且每位审稿人会看到其他审稿人的报告与你的答辩。总述放在给编辑的投稿信而非各审稿人回复开头,投稿信不公开,适合放置不宜给审稿人看的内容。编辑做裁决,决定不是投票;审稿人意见冲突时各自成块回答,把冲突作为事实陈述一次,交由编辑解决,不要用一个审稿人对抗另一个。编辑要求不等于审稿意见,需单独成块。各刊审稿字段不同,收到的报告未必有编号,部分期刊另有代码评估部分,代码意见可能出现在主体意见之外,同样需要单独回复。此技能的审稿报告部分改编自 inno-paper-reviewer,回复对齐层为本仓库原创,来源为已发布的 Nature Portfolio 审稿回复指引与透明同行评审文件。