SuperAPI AI 工具集

subsection-polisher

写作与研究

查看项目

更新于 10-16 04:40

技能介绍

用途

Subsection Polisher 面向综述写作流水线中的局部质量修复。当 sections/S*.md 已经存在但读起来僵硬、模板化时,它用于在 section-merger 合并进 output/DRAFT.md 之前,先对单个 H3 小节做润色,使其读起来更像综述论文的正文段落。它的设计意图是保持局部性:一次只修一个单元,重跑质量门,逐步收敛,而不是重写整篇论文。

触发与适用场景

触发词包括:subsection polisher、per-subsection polish、polish section file、小节润色、去模板、结构化段落。

适用条件:sections/S*.md 已存在但阅读感僵硬或模板化;希望在 section-merger 之前本地修复质量。

该技能的工作对象是一个 sections/S<sub_id>.md 文件,内容为 H3 正文(body-only)。

主要能力与角色

技能定义了两个显式角色:

  • Local Section Editor:改进单个 H3 的论证密度与论文语感,但不改动引用键。做法包括把开篇改写为“张力 → 为什么重要 → 论点”(第 1 段以论点收尾);补充显式对比和评估锚点;增加与本小节相关、能改变解读的局限说明。
  • Evidence Steward:防止在证据单薄时把润色变成编造。如果无法在不猜测的情况下写出对比或评估锚点,就停止并回流上游;不得把结论强化到现有引用无法支撑的程度。

“润色完成”的目标质量包括:第 1 段以论点收尾且不使用叙述模板;至少两处显式对比(A 与 B,使用对比词);至少一段评估锚点(任务/基准 + 指标 + 相关约束/预算/工具访问);至少一段跨论文综合,且同一段落中至少包含两条引用;至少一处与协议不匹配、细节缺失或威胁模型不清相关的局限/警示,而非套话。

论文语感方面,需要删除或改写:大纲叙述(“This subsection ...”“In this subsection, we ...”)、幻灯片式导航(“Next, we move ...”“We now turn to ...”“In the next section ...”)、元指导(“survey synthesis/comparisons should ...”)、重复的证据政策免责套话、以计数开头的句式(如反复用“Two limitations ...”“Three takeaways ...”作为段落开头)。更推荐:内容优先的开头(“A central tension is ...”“In practice, ...”“One recurring pattern is ...”)、论证式衔接(“This contrast matters because ...”“These assumptions shape ...”)、把引用作为证据嵌入句中而非句尾集中标注。

使用方式

输入:目标文件 sections/S<sub_id>.md(H3 正文);优先上下文为 outline/writer_context_packs.jsonl;回退上下文为 outline/subsection_briefs.jsonl 加 outline/evidence_drafts.jsonl;以及 citations/ref.bib。

输出:更新后的 sections/S<sub_id>.md,路径不变,引用键不变。

工作流(单个小节):

  1. 加载小节契约:读取该小节在 outline/writer_context_packs.jsonl 中的 pack;若缺失或单薄,回退到 outline/subsection_briefs.jsonl(论点/张力/段落计划)与 outline/evidence_drafts.jsonl(对比/评估/局限)。在正文之外记录:张力陈述与论点、用于 A 与 B 对比的 2–3 张对比卡、一个最小评估锚点(任务/指标/约束)、一个来自证据包的局限钩子。
  2. 预检(不写入最终正文):草拟四句一行句:张力、对比(A 与 B,至少两条引用)、评估锚点(任务/指标/约束)、局限。如果无法在不猜测的情况下写出,就停止并把缺口回流上游(paper-notes / evidence-draft)。
  3. 开篇重写(第 1 段):去掉叙述式开头;写 1–2 句张力/决策/视角 + 1 句为什么重要 + 以论点收尾。
  4. 段落处理:按“张力 → 对比 → 评估锚点 → 局限”的段落微结构逐段重写;当某段显得像填槽时,可写两个候选改写并保留论证动作更清晰、模板节奏更少的一版(引用不变)。确保包含至少两处显式对比(不是“先说 A 再说 B”的概述)、至少一段评估锚点、至少一段跨论文综合(同段至少两条引用)、至少一处与本小节相关的局限段落或从句。
  5. 引用嵌入:改写那些只在段尾以 [@a; @b; @c] 集中标注的段落,把引用作为证据嵌入论点句;确认保留的每个引用键都在 citations/ref.bib 中定义。
  6. 节奏与去模板:变化段落开头,避免在多段重复同一综合句式(尤其是 Taken together);删除不增加论点、对比、协议细节或局限的空洞衔接句。
  7. 复查:运行 section-logic-polisher 并处理 FAIL(论点与连接词密度),不改引用键;重跑 writer-selfloop(或严格质量门),只修复报告指出的问题。

常见失败与改写意图

  • 叙述式开头 → 内容主张:“This subsection surveys ...”改为“A central tension is ...; this matters because ...”,第 1 段以论点收尾。
  • 幻灯片导航 → 论证桥接:“Next, we move from planning to memory.”改为说明规划与记忆在固定协议下各自决定什么。
  • 免责套话 → 一条政策加局部警示:删除重复的 abstract-only 证据套话;证据政策在 Intro/Related Work 保留一次,H3 中仅当局部警示会改变对某个具体对比的解读时才添加。
  • 元“survey should” → 面向文献的观察。
  • 过于模糊的定量主张 → 添加最小上下文或弱化:若保留数字,在同段补充任务类型/指标定义/约束(预算、成本、工具访问),并保持引用嵌入;若证据包中上下文未知,则改写为定性主张,并把缺失字段标为验证目标(不使用套话)。

限制与停止条件

硬性约束:引用键不可变,不得增删任何 [@BibKey] 标记;范围不可变,所有引用必须留在该 H3 的允许范围内(outline/evidence_bindings.jsonl / writer pack 的 allowed_bibkeys_*);不得编造事实;只输出正文,不加标题(标题由 section-merger 添加)。

当润色是错误选择时应停止并回流上游:无法在不猜测的情况下写出对比(证据包只有标题/摘要);小节缺乏评估锚点(笔记中没有基准/指标/协议细节);持续需要范围外引用才能让论证成立。

资料未提供该技能的具体平台支持、收费方式、价格、安装命令或效果数据。