关于 paper-spine-rewrite
PaperSpine 的学术论文实质性改写技能,依据研究、已确认的动机、证据和写作计划修订现有稿件。改写前须具备研究与引文材料。
主要功能
- 01梳理原稿逻辑
- 02制定证据与章节计划
- 03记录改写决策
- 04执行完整性与评审检查
适用场景
- 01围绕已确认动机重构草稿
- 02依据现有证据修订论点
- 03为最终评审准备论文内容
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ wubing2023/ paperspine --skill paper-spine-rewrite安装后在 Claude Code 中输入/paper-spine-rewrite确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/deep-imitation-protocol.mdlogic-transfer-audit.mdmotivation-thread-writing.mdrewrite-matrix.mdround1-literature-revision.mdround2-journal-revision.mdversion-requirements.mdwriting-rationale-matrix.md详细介绍
PaperSpine Rewrite
当用户已有草稿,并希望对稿件进行实质性改进时,使用此技能。
必需输入
paper_rewriting_output/paper_spine_config.json- 来自
draft_path或对话的用户草稿 paper_rewriting_output/reference_materials/source_index.mdpaper_rewriting_output/research_dossier.mdpaper_rewriting_output/exemplar_learning_dossier.mdpaper_rewriting_output/style_profile.mdpaper_rewriting_output/sota_gap_map.mdpaper_rewriting_output/citation_support_bank.md- 经用户确认的
paper_rewriting_output/confirmed_motivation.md - 来自用户草稿、图、表、数据或笔记的证据
如果缺少研究材料或已确认的动机,请勿改写。返回 paper-spine-research,并在展示基于研究的选项后,请用户确认动机。
如果缺少 citation_support_bank.md,或其中内容过于浅显,请在最终写作前返回 paper-spine-citation。引言、背景、相关工作和讨论中的论点如需文献支持,应参考该资料库。
必需输出
paper_rewriting_output/original_logic_map.mdpaper_rewriting_output/evidence_bank.mdpaper_rewriting_output/section_blueprints.mdpaper_rewriting_output/writing_rationale_matrix.mdpaper_rewriting_output/rewrite_matrix.mdpaper_rewriting_output/logic_transfer_audit.md- 修订后的稿件或章节
- 当
translation_package为zh时,提供translation_zh/包(通过paper-spine-translate)
原始逻辑图
改写前,按顺序梳理现有稿件:
| 原始单元 | 当前文本作用 | 使用的证据 | 与动机的关联 | 问题 | 保留 / 移动 / 改写 / 删除 |
|---|
此步骤必不可少,以便将改写稿与原稿的逻辑进行比较,而不仅仅是比较表面措辞。
写作理由矩阵
在撰写最终文本前,创建 writing_rationale_matrix.md,并阅读 references/writing-rationale-matrix.md。该矩阵是改写计划。行应按稿件实际写作单元排序,而非套用固定的 IMRaD 或期刊论文模板。
使用以下表格:
| 行 ID | 稿件单元 | 原有问题或计划功能 | 与动机的关联 | 从参考范例 / SOTA 学到的模式 | 目标场景或投稿渠道规范 | 用户证据或引文依据 | 计划的改动 | 最终文本检查 |
|---|
第一条数据行必须深入阐明整篇作品的框架或主线:为何选择这一统领结构、SOTA / 目标范例如何为其提供启发、它如何承接已确认的动机、哪些用户证据为其提供支撑,以及如何依据它检查最终稿件。之后,针对目标场景,将草稿拆分为尽可能小且有用的单元:段落、段落组、结果 / 论点单元、模型步骤、假设、综述综合块、竞赛解题块、标题、图注或其他承载论证的片段。如果报告、综述或竞赛论文不适合采用摘要 / 引言 / 方法 / 结果 / 讨论结构,就不要强行套用。
每一行都必须从多个维度说明具体依据。可接受的理由包括:确认或收窄核心动机;借鉴优秀范例中的结构手法,但不照搬措辞;符合目标场景的预期;让证据紧邻论点;修复薄弱的过渡;形成前后呼应;或将论点限制在现有证据能够支持的范围内。如果某一行无法让用户明白该写作手法为何更好,就说明理由过于浅显。
Humanize 等级
如果 paper_spine_config.json 中的 humanize_tier 设为 light、medium 或 heavy,请在写作前转至 paper-spine-humanize。humanize 技能会提供分级写作约束,并在所有文本生成过程中强制执行这些约束。
重写规则
- 根据
writing_rationale_matrix.md重写,不要通过向旧段落追加句子来完成。 - 只有当矩阵明确说明某段落为何已符合已确认的动机时,该段落才可以保持不变。
- 只有用户提供的证据支持时,才保留用户的主张。
- 除非用户要求更改结构,否则保留 LaTeX 命令、标签、引用、公式、图和表。
- 使用配置中的
output_language:en表示英语,zh表示中文。 - 仅当引用能支持某个具体句子时,才从
citation_support_bank.md中选择引用。不要在缺乏明确论点时添加成组引用。 - 目标场景的写作风格应服从已确认的动机。
rewrite_matrix.md必须将原始单元映射到最终单元,并说明每项更改属于结构性、修辞性、证据相关还是仅涉及语言。
LaTeX 前置检查
将输出发送至 paper-spine-latex 之前,运行:
python scripts/integrity_audit.py paper_rewriting_output --markdown --write
python scripts/structured_review.py paper_rewriting_output --dispatch
integrity_audit.md 不得包含任何 BLOCKED 结果。发送后,根据 review_prompts/dispatch.md 启动三个并行审查子 Agent。使用 structured_review.py --validate review_prompts 验证审查的独立性。
进行实质性重写时,请阅读 references/writing-rationale-matrix.md、references/motivation-thread-writing.md、references/deep-imitation-protocol.md 和 references/rewrite-matrix.md。