用途
Auto Paper Improvement Loop 用于在论文草稿上运行受控的多轮「评审 → 实施 → 重新编译」循环,帮助提升写作质量。它适合以下情形:
- 论文草稿需要在单遍一致性编辑之外进行迭代式写作质量改进;
- 评审独立性重要——带有先前上下文的评审会抬高评分并遗漏真实问题;
- 论文的某些部分(定理、数值、引用)应在写作过程中保持冻结;
- 长时间改进会话可能横跨多个智能体会话,需要崩溃恢复;
- 需要记录草稿版本之间改动的差异日志。
该技能明确不用于:替代真实评审人反馈(如需先识别结构性风险,应先用 paper-reviewer-simulator);也不用于对实验结果做判断(应先用 result-diagnosis 或 research-results-auditor)。
主要能力与核心原则
- 评审独立性:每轮评审子任务必须以无先前轮次记忆、无作者意图、仅含论文文本的全新上下文启动,从写入者会话延续的评审会产生虚高评分。
- 编辑白名单:在循环开始前声明冻结内容,防止写作质量修改过程中引入新论断、新引用或新数值。
- 轮次建议:通常两轮足够——第 1 轮发现最明显问题,第 2 轮发现第 1 轮修复所引入的问题;第三轮很少发现真正的新问题,且有过度打磨风险。
- 每轮存档:多轮循环耗时较长,每完成一轮即写入状态。
使用方式
第 1 步 — 配置循环。 开始前决定:轮数(默认 2;快速 1;高风险投稿 3);模式(writing | theory | format | full);编辑白名单——冻结项(定理/引理/证明正文、任何数值结果、引用键与参考文献列表、章节结构与顺序);允许项(行文改写、段内重排、图注改写、过渡句、记号一致性修正)。保存配置与当前 PDF(或 .tex 哈希)作为基线。
第 2 步 — 初始化状态。 创建 paper/.agent/PAPER_IMPROVEMENT_STATE.json,包含 loop_id、rounds_planned、rounds_completed、mode、edit_whitelist_frozen、baseline_tex_hash、round_summaries、status 等字段。
第 3 步 — 运行评审轮(评审独立性协议)。 准备仅含论文文本的自包含评审提示词,不包含先前评审历史、作者意图或会话上下文。使用 sidecar-task-runner 配合全新 Codex 会话(codex exec --ephemeral)作为隔离子任务运行,或显式开启无延续性的新 Claude 会话;绝不可从当前智能体会话继续执行评审。评审提示词应要求:逐节清晰度问题、论证流程问题、呈现问题(图表未在正文提及、未定义记号)、针对写作契约的格式违规,以及影响最大的 5 项修复排序清单。评审输出保存至 paper/.agent/sidecars/improvement-round-<N>/output.md。
第 4 步 — 实施修复(白名单强制)。 逐项检查修复是否触及冻结类别,若触及则记录拒绝日志(如 REJECTED: [fix description] — touches frozen category [category]);对允许的修复在 .tex 源码中实施,重新编译确认无错误,并在轮次摘要中记录已实施改动。
第 5 步 — 复述回归检查(theory 模式)。 对主论文中的每个定理/引理,定位其在附录中对应的复述,确认语句正文逐字节一致或语义等价,标记主论文与附录复述之间的任何漂移。
第 6 步 — 更新状态与日志。 每轮后更新 rounds_completed 与 round_summaries(含 round、review_output、fixes_implemented、fixes_rejected、recompile_status),并使用 templates/improvement-log.md 写人类可读日志。
第 7 步 — 最终格式检查。 页数在会议限制内;无重复 \label{} 键;无指向未定义标签的 \ref{};编译日志中无明显 overfull hbox 警告(检查 Overfull \hbox 行 > 10pt);如会议有要求,摘要字数在限制内。
第 8 步 — 路由后续步骤。 循环后运行 submit-paper 做最终投稿预检;若循环中发现结构性问题,运行新的 paper-reviewer-simulator 模拟;对需要大幅重写的章节,用 paper-writing-assistant 起草新内容。最后将状态标记为 "complete"。
渐进式加载
开始新循环前读取 templates/improvement-log.md;读取 paper-writing-assistant/references/edit-whitelist-contract.md 以选择或自定义本循环的编辑白名单预设;当 paper/.agent/writing-contract.md 存在时读取以了解受保护的不变量;恢复中断循环时读取 paper/.agent/PAPER_IMPROVEMENT_STATE.json。
崩溃恢复
循环被中断时:读取状态文件找到 rounds_completed;从下一轮继续,不要重跑已完成的轮次;若最后完成轮的 recompile_status 不是 success,先修复编译错误再继续。
最终健全性检查
标记循环完成前确认:所有计划轮次已完成;每轮评审都使用了全新上下文(无延续);白名单拒绝已记录;论文可干净编译;改进日志已保存;状态文件 status 为 "complete"。
目录结构与配套技能
技能目录包含 SKILL.md 与 templates/improvement-log.md。配套技能:首轮循环前用 paper-reviewer-simulator 识别高优先级问题;不需要完整多轮迭代时用 paper-draft-consistency-editor 做单次针对性处理;某轮评审指出需大幅重写的章节时用 paper-writing-assistant;最后一轮后用 submit-paper 验证投稿就绪度。
限制
该技能不能替代真实评审人反馈,不用于对实验结果做判断。定价、平台支持范围等具体信息在所提供的资料中暂未提供。