Skip to content

wp-a/paper-refine

Repository files navigation

PaperRefine

修改已有论文:逻辑更清楚,主张更稳,英文更自然。

不会改动你的科学事实;每一处关键修改都说明为什么。

Codex Claude Code CI Version License: MIT

中文 | English

先看效果

Before After
This excellent model could revolutionize battery management. These results support further evaluation of the model for battery-management applications.
回顾性观察研究“证明 X 直接导致 Y,并适用于所有人群” X was significantly associated with Y. 因果与普适性结论被限制到研究设计实际支持的范围。

PaperRefine 不只是替换同义词。它先保护数字、引用、术语、比较方向和限定条件,再检查段落逻辑、论点—证据关系与主张边界,最后才改写英文。完整案例见效果示例

为什么有用

  • 先改逻辑,再改句子:处理段落职责、论证顺序、重复和缺失桥接,不在坏逻辑上做表面润色。
  • 高风险优先:先查标题、摘要结尾、贡献点及因果、机制、泛化、创新性和性能主张,再处理普通语法与措辞。
  • 主张不越过证据:区分观察、关联、预测、因果、机制、创新性和泛化,不把相关性写成因果性。
  • 中文科研写作友好:把中文草稿重组为自然英文,而不是逐句直译;默认用中文解释主要修改。
  • 修改可以核对:支持 Before/After change ledger,并把需要作者判断的项目标记为 author-check
  • 格式保真:保护 LaTeX 命令、公式、引用键、标签、数值和转义字符。

安装

Codex

codex plugin marketplace add wp-a/paper-refine
codex plugin add paper-refine@paper-refine

Claude Code

claude plugin marketplace add wp-a/paper-refine
claude plugin install paper-refine@paper-refine

全局 Skill、项目内 Skill、升级、卸载及从 nature-polishing 迁移的方法见完整安装说明

直接这样用

Codex

使用 $paper-refine 润色这段英文论文,保留所有数字、引用和限定条件,并用中文说明关键修改。

Claude Code 插件

/paper-refine:paper-refine 把这段中文 Results 改写成严谨、自然的学术英文,不要新增实验或机制。

两端都可以继续使用这样的任务描述:

检查这段 Discussion 的因果、泛化和创新性主张;给我 Before/After 修改对照。

Codex 使用 $paper-refine;通过 Claude Code 插件安装时使用 /paper-refine:paper-refine。两者不是同一种调用语法。自然语言自动选择 取决于当前模型和运行模式,不作为可靠的安装验证方式。

两种工作模式

模式 适用情况 行为
Quick 一句话到约三个段落,目标明确 直接保护事实、校准主张、润色并复核,不增加无谓提问
Deep 长段落、完整章节、逻辑重构或详细修改审计 Protect → Diagnose → Calibrate → Rewrite → Naturalize → Verify

默认结果包括:

  1. Refined text:可以直接使用的修改稿。
  2. Why it is better:3–5 条中文修改理由。
  3. Author checks:仅在科学事实、术语、引用或证据需要作者确认时出现。

适用范围

PaperRefine 处理已经存在的学术文本

  • 英文论文润色与段落重构
  • 中文科研草稿转学术英文
  • 摘要、引言、方法、结果、讨论、结论、标题和图注
  • 过度主张、因果边界、术语一致性和 LaTeX 保真

它不负责:

  • 从零生成整篇论文
  • 搜索文献、补引用或从记忆生成 BibTeX
  • 模拟审稿、回复审稿人或撰写投稿信
  • 数据分析、科研绘图或论文转 PPT
  • 承诺期刊接收、判定作者身份或降低 AI 检测分数

这些边界让自动触发更准确,也避免一个 Skill 接管所有科研任务。

示例

双平台同一套行为

根目录的 SKILL.mdreferences/ 是唯一源文件。发布脚本把它们同步到 Codex/Claude Code 共用的插件目录,CI 会拒绝任何镜像漂移。平台差异只存在于清单和安装方式,润色规则、示例和测试完全一致。

质量与安全

  • 24 个触发边界 fixture:12 个正例,12 个近似误触发反例。
  • 保护语料覆盖数字、否定、比较方向、人群范围、引用和 LaTeX。
  • 4 个已提交前向用例:主张校准、最小改动、LaTeX 保真和近似误触发,CI 自动评分。
  • 自动检查 frontmatter、插件清单、镜像同步、文档链接和版本一致性。
  • 示例只证明可复现的编辑行为,不宣传投稿成功率或 AI 检测分数。

评估方法和已知限制见评估记录

仓库结构

paper-refine/
├── SKILL.md                 # 唯一核心入口
├── references/              # 六份按需加载的编辑指南
├── examples/                # 可核对的 Before/After
├── plugins/paper-refine/    # Codex + Claude Code 分发包
├── scripts/                 # 同步和仓库验证
├── tests/                   # 触发、契约、示例与打包测试
└── docs/                    # 安装、维护和评估

维护流程见维护说明,参与开发见贡献指南

设计参考

本项目调研并吸收了以下开源项目在模块化、论点—证据检查、反向提纲和双平台安装方面的经验,但核心 Skill、示例和测试均在本仓库重新设计:

License

MIT © 2026 wp-a

About

中文优先的学术论文润色与逻辑重构 Skill,保留科学事实并支持 Codex 与 Claude Code。

Topics

Resources

License

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages