From light
Polishes academic papers from a reviewer's perspective with modular editing (language, logic, structure, innovation, argumentation). Useful for authors improving readability and reviewer impact.
How this skill is triggered — by the user, by Claude, or both
Slash command
/light:light-paper-polishingThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
分两层:**表层**(语言、术语、句式、可读性)+ **深层**(逻辑、论证、结构、创新点呈现)。深层优先——审稿人拒稿很少因为语法。
分两层:表层(语言、术语、句式、可读性)+ 深层(逻辑、论证、结构、创新点呈现)。深层优先——审稿人拒稿很少因为语法。
五问是"审什么";具体"怎么改"见
references/argument_review.md——Claim–Evidence–Boundary 三件套、Hedging 校准阶梯(主张强度匹配证据)、章节责任分工(Results 不堆机制 / Methods 过可复现测试 / Discussion 才 hedging)、AI 使用披露。两者配套用。 按审稿打分维度组织(综合 Elsevier reviewer 指南与会议式评审):
\cite{authorYearWord}(第一作者姓+年份+标题首个实词,全小写,如 \cite{zhang2024deep}),发现 [Zhang 2019] 式自由文本占位要改成该公式——否则排版报 undefined citation;此公式与 m10 pin 的 .bib 键同源。引言按"四段式"对位:背景痛点 → 现有方法不足(动机) → 我们的洞察/做法 → 贡献列表。
engagement/华丽用词在学术稿里弱化——别为多样性牺牲精确。 首选可直跑(免费匿名):LanguageTool 公共云端点
POST https://api.languagetool.org/v2/check,参数language=en-US(或auto)、level=picky(开严格风格规则)、motherTongue=zh-CN;匿名实测 HTTP 200,返回matches[]带message/replacements/offset,逐条核对。隐私/批量场景改自托管。 一行可跑示例:curl -s -X POST "https://api.languagetool.org/v2/check" \ -d "language=en-US" -d "level=picky" \ --data-urlencode "text=This sentence have a error." | python -m json.toolDeepL 改写需付费 key,不能匿名跑:
/v2/write/rewrite两个 host 实测均 404,/v2/translate实测 403(需Authorization: DeepL-Auth-Key);故 DeepL 仅作"有 key 时整句改写参考",writing_style=academic偏整句重述、易动术语与作者声音,必须人工复核(端点存活情况见 references.md)。学术措辞向 Writefull"已发表语料惯用表达"思路看齐,而非通用语法。
每处修改给出:问题 → 原因 → 修改方案 → 修改后文本,必要时 before/after 对照。重大重构先说思路再改。保留作者声音,不过度改写(DeepL 式整句重述会冲淡声音,慎用)。摘要/引言/结论按 db02 高水平套路(patterns_library 方法论层,领域中立)重写;该套路已剥离 cs.AI/CV 文化背书,润色统计/医学/农业等非 CS 稿时不照搬"beat baseline/SOTA/开源"式表达(见 samples_real D 表偏科警示)。
输出格式固定为「原句 → 问题诊断 → 修改后 → 为什么更好」。下面三例分别覆盖深层(soundness)、表层(clarity)、贡献呈现(novelty)三类。
例 1 · 深层 / 裸论断(soundness)
例 2 · 表层 / 长从句+指代不清(clarity)
例 3 · 贡献呈现(novelty,引言/摘要三处一致)
三个产物把上面的方法落成可运行工具,输出同构结构化发现(schema 见 references/findings_schema.md)。下游消费:m14 review-rebuttal 模拟审稿前读这份 findings JSON 当预审输入——overclaim/claim_strength 映射到 Soundness/Significance 的 major 意见、ai_tone/punctuation 等映射到 Presentation 的 Minor(字段映射在 m14 SKILL「消费 m08 润色发现」节),故 category 取值与 schema §4 的 severity 分档须稳定,改字段名两处同步。
scripts/polish.py:封装 LanguageTool 匿名云端点 POST https://api.languagetool.org/v2/check(level=picky、motherTongue=zh-CN)。自动按段落/句子分块(单块 <18000 字符,避开匿名 ~20k 上限),把每条 match 的 offset 映射回原文绝对 line/col。已修限流缺陷:改每 chunk 独立降级——某 chunk 非 200 只对该 chunk 退本地正则、其余 chunk 的 LanguageTool 结果保留(不再一块失败全篇丢弃,mode=mixed);chunk 间 sleep 控速(~20 req/min),429/5xx 指数退避重试。_meta.http_codes 记运行时真实 HTTP 码,绝不伪造云端结果。
mode=languagetool http=[200],返回 EN_A_VS_AN/PLURAL_VERB_AFTER_THIS 等真实规则。python scripts/polish.py --file paper.txt --json 或 echo "..." | python scripts/polish.py。scripts/mechanical_check.py(无需 API):扫 ① overclaim 黑名单(significant/seminal/novel/outperforms…,统计语境的 significant 已上下文豁免不误报)② AI 腔/填充语 ③ hedge 堆叠 ④ claim_strength:强主张词(prove/conclusively/unprecedented/always…)给 Hedging 阶梯降级建议(对接 references/argument_review.md §2,已纳入 schema §3/§4)⑤ 段落被动句占比超阈值 ⑥ 标点卫生。已修工程缺陷:--latex 先 strip_latex 去 \cite/$...$/注释/environment 再查(保行号,治 .tex 误报);句切分加缩写保护(et al./e.g./Fig. 不误断);中文稿支撑中文夸大词/AI 腔词表(显著/大幅提升/综上所述…)。输出 {line,col,category,issue,suggestion,context}。纯 stdlib,任何环境可跑。
python scripts/mechanical_check.py --file paper.txt --json;.tex 自动或显式 --latex。python <script> 永远能跑通。LanguageTool 管表层语法,mechanical_check 管 LanguageTool 漏掉的"学术腔/裸论断",二者互补。scripts/style_fingerprint.py(无需 API):文风校准。通用润色容易把每个人都改成同一种"标准学术腔";这个脚本相反——先从用户已认可的过往文稿量出个人文风指纹(句长节奏、被动比例、第一人称、连接词偏好、标点习惯、高频实义词),润色时校准到作者自己的声音,而非抹平成模板。--build past*.txt --out style.json 建指纹;--compare draft.txt --ref style.json 标出待润色稿偏离作者习惯最大的维度并给调整提示。指纹只是统计画像,"改成什么样"仍是作者判断,脚本不自动改写。
python scripts/style_fingerprint.py --selftest,或建指纹后 --compare draft.txt --ref style.json。一段引言走完四步流水线(原始段落 → 跑脚本命中 → 四栏逐条改 → 终稿,含 overclaim/ai_tone/passive/hedge 四类命中的修法)见
examples/full_pipeline_walkthrough.md。上方「示范:润色长这样」已示范 soundness/clarity/novelty 三种单句改法,端到端整段演示移至 examples 按需查。
与 m07 交替循环;改完跑 m14 模拟审稿验证;术语对齐 db09;引用问题转 m10(正文 \cite{} 占位用 authorYearWord 公式,与 m10 pin 的 citekey 同源)。交付前过 a08(light-self-review)自检闸门。每轮记录版本到 db09。
落盘工件名(CONVENTIONS §6.1):m08 在 m07 的
draft.md同稿上迭代润色,不另起新工件名;版本迭代记入 db09。
工具与方法的逐条核查笔记见
references.md(含 LanguageTool/DeepL 真实端点参数、Writefull/Paperpal/Grammarly 能力边界、各写作 skill 工作流);结构化发现字段契约见references/findings_schema.md;可跑脚本在scripts/polish.py、scripts/mechanical_check.py。
npx claudepluginhub light0305/light-skillsProvides systematic top-down workflow to polish academic papers: structure to logic to expression with user confirmations at each step. Activates on requests to revise or improve papers section-by-section.
Self-reviews paper paragraphs (intro, abstract, method, related work) across five axes: logic, expression, detail, framing, reader orientation. For v1→v2 revision, not drafting from scratch.
Polishes academic prose into Nature-leaning English using writing-strategy principles and curated article patterns. Useful for manuscript sections, abstracts, and Chinese-to-English translation.