paper-writing-assistant

论文写作助手

与作者共同撰写论文。此技能用于撰写和编辑论文文本，而非模拟审稿人。它会在撰写摘要、引言、方法、实验、结果、局限性和结论等部分时，确保论文的主张、投稿 venue 风格、证据和临时占位内容保持一致。

适用于以下场景：

• 起草或改写论文各部分
• 将实验结果转化为支持主张的结果描述
• 根据目标 venue 和论文定位调整语气、结构和段落衔接
• 撰写图注、表注、段落开头、段落结尾、贡献要点、过渡句和局限性表述
• 编辑单个部分时，确保主张清晰可见
• 针对布局、流畅度、论证、技术一致性、风格一致性、venue 适配或最终润色进行分层编辑
• 实验尚未完成时，插入明确标记的临时结果
• 稍后用已验证结果替换临时占位内容
• 维护写作记录，跟踪未解决的占位内容、过时的结果描述和主张措辞决策

不要用此技能像苛刻的审稿人一样评审论文。使用 paper-reviewer-simulator 评估论文的录用风险。使用 conference-writing-adapter 调整 venue 层面的结构并制定段落蓝图。在进行重要编辑前后，使用 paper-writing-memory-manager，以便局部文本修改能更新整体写作状态。当主要任务是整理主张与证据清单，而非撰写文本时，使用 paper-evidence-board。撰写过程中发现缺少结果，且现有 CSV 可能已包含所需证据时，使用 paper-evidence-gap-miner。当原始 CSV 结果需要整理成面向论文的表格或图表时，使用 paper-result-asset-builder。只有在 gap miner 确认需要新增计算时，才使用 experiment-design-planner。

核心原则

• 以作者身份写作，而非以审稿人身份评判。输出应是可直接用于论文的文本或具体的编辑计划。
• 保留论文的科学主张。改进清晰度、强调重点和解释，但不要暗中改变论文所表达的主张。
• 进行重要编辑前，先声明当前写作层级。布局、流畅度、论证、技术一致性、风格一致性、venue 适配和最终润色各自有不同的权限范围。
• 结合主张解读结果。结果描述应说明证据为何支持、限定或使主张更复杂。
• 明确标注证据状态。已验证结果、用户陈述的结果、推断性解读和临时占位内容不可混为一谈。
• 清晰优先于文风：逻辑严谨、论据站得住脚、减少理解成本和提高信息密度，比措辞优雅更重要。
• 不要让写作掩盖实验优势。若计算资源、数据、训练时长、调参预算、模型规模、硬件、提示词或协议方面的差异会影响比较，就必须清楚呈现。
• 临时结果只能作为标记清楚的写作脚手架使用。最终投稿前，必须能在源文件中检索到这些内容，并将其记录在写作记录中。
• 若缺少必要实验，应先撰写当前条件下最完善的章节，同时创建占位内容和待办事项，而不是停止所有写作。
• 优先使用本地草稿文件、项目记忆和证据材料，而非依赖记忆。不要编造最终数字。
• 具体的文本写作技巧应参考有依据的写作范例。不要模仿或存储范例论文中的长段落。

技能目录结构

<installed-skill-dir>/
├── SKILL.md
└── references/
    ├── style-selection.md
    ├── paper-quality-heuristics.md
    ├── evidence-recipes.md
    ├── exemplar-index.md
    ├── exemplars/
    │   └── *.md
    ├── section-patterns/
    │   ├── abstract.md
    │   ├── introduction.md
    │   ├── method.md
    │   ├── experiments-results.md
    │   ├── related-work.md
    │   └── limitations-conclusion.md
    └── micro-patterns/
        ├── paragraph-openings-closings.md
        ├── result-interpretation.md
        ├── figure-captions.md
        ├── table-captions.md
        └── transitions-and-positioning.md

渐进式加载

在进行实质性起草或修订前，务必先阅读 references/style-selection.md。

在撰写或修订标题／摘要／引言／结果／结论时，如果草稿显得缺乏重点、需要进行超出语法层面的润色，或需要检查文字是否掩盖了证据薄弱、逻辑混乱或比较不公平等问题，请阅读 references/paper-quality-heuristics.md。

在选择论文结构、解读结果、判断某项主张是否有证据支持，或处理缺失的实验时，请阅读 references/evidence-recipes.md。用它将主张对应到必需、建议、可选和阻断性证据槽位。

当用户要求基于示例论文写作、投稿 venue 或主题定位很重要，或需要借助成功论文中的具体先例时，请阅读 references/exemplar-index.md。然后仅加载 references/exemplars/ 中 1 至 3 个相关文件。

然后仅加载相关的章节模式：

• 摘要：references/section-patterns/abstract.md
• 引言和贡献列表：references/section-patterns/introduction.md
• 方法、理论设定、基准设计或系统设计：references/section-patterns/method.md
• 实验、结果、分析和消融实验：references/section-patterns/experiments-results.md
• 相关工作和创新边界：references/section-patterns/related-work.md
• 局限性、广泛影响、伦理、范围和结论：references/section-patterns/limitations-conclusion.md

根据写作任务加载微模式：

• 段落开头、段落结尾和局部衔接：references/micro-patterns/paragraph-openings-closings.md
• 结果表述、消融实验解读、主张与证据之间的衔接，以及暂定结果的表述：references/micro-patterns/result-interpretation.md
• 图注：references/micro-patterns/figure-captions.md
• 表注：references/micro-patterns/table-captions.md
• 章节过渡、贡献要点、相关工作定位和局限性表述：references/micro-patterns/transitions-and-positioning.md

根据需要阅读本地项目资料：

• 了解项目事实：memory/claim-board.md、memory/evidence-board.md、memory/action-board.md 和 paper/.agent/paper-evidence-board.md
• 了解当前写作状态、章节状态、依赖关系、风格决策、待解决事项和编辑影响历史：paper/.agent/writing-memory/
• 了解写作层次、用户偏好、受保护的不变量、术语和符号约定：paper/.agent/writing-style.md、paper/.agent/writing-style-lessons.md、paper/.agent/notation-contract.md 和 paper/.agent/writing-memory/style-and-terminology.md
• 撰写内容依赖于从 CSV 派生的结果资源时：paper/.agent/evidence-completion-plan.md、paper/.agent/result-inventory.md 和 paper/.agent/result-asset-provenance.md
• 了解临时结果占位内容：paper/.agent/provisional-results.md
• 了解当前写作状态：paper/.agent/paper-status.md
• 结果表述依赖于图表时：paper/.agent/visual-style.md 以及图表映射文件
• 目标论文文件，例如 main.tex、paper.tex、sections/*.tex、figures/、tables/ 和附录文件

如果目标 venue 的风格或章节结构不明确，请搭配使用 conference-writing-adapter。每当文字修改改变了主张、结果解读、章节状态、图注、术语、写作层次、风格经验或待解决的写作事项时，请搭配使用 paper-writing-memory-manager。如果写作过程中发现主张与证据出现偏差，请搭配使用 paper-evidence-board。在要求开展新实验前，请搭配使用 paper-evidence-gap-miner，因为现有 CSV 结果可能已经能支持该主张。如果结果表述需要根据 CSV 生成面向论文的表格或图表，请搭配使用 paper-result-asset-builder。

步骤 1 - 定义写作任务

明确：

• 目标投稿 venue 和年份（如已知）
• 论文定位或类型：方法、基准测试、实证研究、理论、系统、分析、应用或混合型
• 主题领域及最接近的范例类别（如已知）
• 目标章节和所需模式：起草、改写、修订、压缩、扩写、润色或填充占位符
• 可用来源：大纲、笔记、TeX 文件、结果表格、图表、日志或记忆板
• 此轮是否允许使用临时占位符
• 微型写作目标（如有）：段落开头、段落结尾、图注、过渡、结果解读、贡献要点、局限性或相关工作定位
• 当前写作层级（如已知）：layout、surface-fluency、argument、technical-consistency、style-consistency、venue-adaptation 或 final-polish

如果用户只要求“帮忙写”，但未提供更多细节，则默认：

1. 阅读当前摘要、引言，以及论点／证据记忆（如有）
2. 生成论文概览
3. 提议接下来要撰写或修订的章节
4. 上下文充足时，撰写具体的章节草稿

步骤 2 - 构建写作概览

撰写大段正文之前，提取：

## Writing Snapshot
- Target venue:
- Paper positioning:
- Active section:
- Main claim:
- Secondary claims:
- Required evidence:
- Available evidence:
- Missing evidence:
- Evidence recipe loaded:
- Paper quality heuristics loaded:
- Evidence slot status:
- Tone/style target:
- Active writing layer:
- Protected invariants:
- Exemplars loaded:
- Section pattern loaded:
- Micro-patterns loaded:
- Provisional placeholders allowed: yes/no

如有可用的论点 ID，请使用 CLM-001 等 ID。如果项目没有 ID，请分配本地 CLM-TMP-001 ID，并建议将其同步到 paper-evidence-board 或项目记忆中。

步骤 3 - 选择写作模式

阅读 references/style-selection.md，然后选择：

• 一个 venue／主题／定位风格配置
• 一个适用于论文主要类型的证据方案
• 具体先例有参考价值时，选择零到三个范例卡片
• 一个适用于当前章节的章节模式文件
• 一到三个适用于具体写作操作的微型模式文件

按以下方式选择：

venue + topic + positioning + section + paragraph job + evidence type
-> section pattern + micro-patterns

示例：

• NeurIPS + method + introduction + gap paragraph + claim framing -> section-patterns/introduction.md + micro-patterns/paragraph-openings-closings.md
• CVPR + benchmark + figure caption + visual evidence -> micro-patterns/figure-captions.md
• ACL + empirical study + result paragraph + table evidence -> section-patterns/experiments-results.md + micro-patterns/table-captions.md + micro-patterns/result-interpretation.md
• ICLR + method + ablation interpretation + mechanism claim -> section-patterns/experiments-results.md + micro-patterns/result-interpretation.md

如果要撰写完整章节，先加载章节模式，再仅为需要具体指导的段落、图注、过渡或要点补充微型模式。如果只写图注、过渡或段落开头，则加载相关微型模式，无需加载整份章节文件。

加载范例时，仅将其用于：

• 章节内容的展开顺序
• 段落任务的安排顺序
• 图注和结果正文的写作策略
• 证据的呈现位置
• 语气和范围的把握

不要照搬范例措辞。不要让知名范例凌驾于用户的实际论点或证据之上。

步骤 4 - 映射证据槽位

撰写听起来像定稿的正文之前，使用 references/evidence-recipes.md 将当前论点映射到证据槽位。

对每个主要论点，进行分类：

- Claim:
- Archetype:
- Required evidence slot:
- Current status: filled / user-stated / planned / running / provisional / missing / contradicted / not-needed
- Paper location:
- Writing consequence:

规则：

• filled 证据可作为已观察到的证据来表述。
• user-stated 证据可用于起草，但如果尚未检查相应材料，应标记为待核实来源。
• planned、running 或 missing 证据需要使用暂定措辞、采取行动或缩小论点范围。
• contradicted 证据需要诊断结果、缩小论点范围，或调整论文定位。
• 证据方案中缺失的关键槽位应阻止提出强有力的定稿论点。
• 对隐藏的计算资源、数据、调参、硬件、评估或选择优势有依赖的论点，必须改写为明确范围，或在撰写定稿正文前转交来源核查／基线审计。

步骤 5——撰写与论断相符的文本

将选定的模式应用于用户的论文，而不是照搬模板措辞。对于每个段落、图注或项目符号，都要在内部维持一份工作约定：

- Active layer:
- Paragraph job:
- Claim supported:
- Evidence used:
- Reader question answered:
- Risk if overclaimed:
- Protected invariants:

除非用户要求提供大纲，否则最终文本中不应包含这份约定。使用它来保持写作严谨。

应用 references/paper-quality-heuristics.md 中的论文质量门槛：检查过渡是否体现真实逻辑、强论断是否有据可依、概念是否在首次出现附近得到解释，以及每个段落是否针对其在论文中的位置提供了足够有用的信息。

对于图注：

- Figure job:
- Claim supported:
- Setup/protocol:
- Visual encoding:
- Takeaway:
- Caveat:

对于表格标题：

- Table job:
- Claim supported:
- Comparison question:
- Protocol/metrics:
- Formatting rule:
- Main takeaway:
- Scope caveat:

结果解读应遵循以下模式：

1. 陈述比较或观察结果
2. 指明测量设置
3. 说明相对于相关基线或对照发生了哪些变化
4. 解释这如何支持论断
5. 如有需要，说明边界条件或局限性

避免使用“显著提升性能”这类空泛论断，却不说明在哪种情况下、相较于什么，以及这为何重要。

各层权限：

• layout：可为适应页面布局在局部缩短或调整文本，但须保留论断强度、符号记法和证据解读。
• surface-fluency：可改善语法和行文流畅度，但不得改变段落作用或论断范围。
• argument：可重新排序或重构论断，但必须检查证据板和写作约定。
• technical-consistency：可统一名称、符号记法、指标和标签，然后标记依赖这些内容的位置为过时。
• style-consistency：可依据 writing-style.md 统一语气、节奏和论断强度的表达习惯。
• venue-adaptation：可根据投稿场所的预期调整重点，但定位上的改动需要写作约定。
• final-polish：仅在结构稳定后进行；避免引入新的论断、术语或证据依赖。

步骤 6——写作时处理缺失的实验

当写作过程中发现缺少结果时：

1. 判断能否先用临时占位符起草文本
2. 在论文源文件中插入可搜索的标记
3. 创建或更新 paper/.agent/provisional-results.md
4. 如有项目记忆，则创建一项后续操作
5. 在回复摘要中提及该占位符
6. 将占位符关联到其对应的证据方案条目

在论文文本中使用以下标记格式：

\textbf{[PROVISIONAL-RESULT PR-001: replace with verified result for CLM-001]}

如果投稿场所或项目风格不适合使用醒目的粗体占位符，则使用 LaTeX 注释加方括号包裹的文本：

% PROVISIONAL-RESULT PR-001: replace with verified result for CLM-001
[PR-001: pending main result on DATASET against BASELINE]

绝不要在看起来像最终稿的文本中插入未标记的临时数值。如果用户明确要求暂定数值目标，应将其标记为目标或占位符，而非观测证据。如果缺失的证据属于论文类型的阻断项，则应缩小论断范围，或记录一项必须在投稿前解决的操作。

步骤 7——维护临时结果台账

如果存在临时占位符，则创建或更新：

paper/.agent/provisional-results.md

使用以下格式：

# Provisional Results

## Open Placeholders

### PR-001
- Status: open
- Claim: CLM-001
- Paper location:
- Draft text:
- Placeholder value:
- Evidence recipe slot:
- Why this value supports the claim:
- Required real experiment:
- Expected source artifact:
- Owner:
- Created:
- Replacement rule:

## Resolved Placeholders

### PR-000
- Status: resolved
- Claim:
- Paper location:
- Final value:
- Source artifact:
- Resolved:
- Notes:

替换规则示例：

• 将占位符替换为来自 code/docs/results/... 的已验证指标
• 如果任何主要数据集上的结果低于基线，则弱化论断
• 如果消融实验未能隔离出作用机制，则删除相应段落

步骤 8——替换临时结果

获得真实结果后：

• 查找每个 PROVISIONAL-RESULT 和 PR-### 标记
• 如果结果改变了整体叙述，则更新正文、表格、图注以及摘要／引言中的论断
• 将台账条目从未解决状态移至已解决状态
• 如有 paper-evidence-board，在其中将过时的文本或图表标记出来
• 如果真实结果与论断矛盾，则转交给 result-diagnosis 处理，或缩小论断范围，而不要强行使用支持该论断的措辞

投稿前，论文源文件中不得保留任何未解决的 PROVISIONAL-RESULT 标记。

步骤 9 - 编辑文件

对于 LaTeX 项目：

• 编辑最小范围内相关的 sections/*.tex 文件
• 保留标签、引用、宏和换行符
• 除非用户要求，否则不要重新组织源代码树
• 存在临时占位符时，使用 LaTeX 注释以便追溯
• 除非为保持论述一致性需要同步修改，否则仅在所请求的章节内调整文案

如果是在聊天中提供文案，而非编辑文件，也要列出所有临时占位符以及应创建的账本条目。

最终检查

定稿前：

• 文案符合目标投稿渠道和论文定位
• 每项主要论断都支持或保留了一项明确命名的主张
• 主要主张满足所选论文类型的必备证据要求，或已明确缩小范围
• 结果解读说明了证据如何支持该主张
• 适用时，图注应说明主张、设置、图表编码方式和要点
• 段落的开头和结尾服务于章节论证，而非仅用于衔接行文
• 未经核实的事实已标记为临时内容、用户陈述或待核实
• 每项临时结果都有 PR-### 标记和对应的账本条目
• 没有将临时文案伪装成最终观测证据
• 如果存在项目记忆，缺失的实验应附有后续行动
• 非轻微修改应符合已声明的写作层级；否则，应重新分类并写回记忆