SuperAPI AI 工具集

section-logic-polisher

写作与研究

查看项目

更新于 10-16 04:41

技能介绍

Section Logic Polisher(thesis + argument bridges)是一个用于研究论文写作流水线的技能,定位为“每个 H3 小节的局部逻辑润色步骤”,发生在草稿撰写之后、章节合并之前。它的目标是弥合即使小节篇幅较长、引用密集时仍然存在的“论文感”缺口。

用途 该技能针对两类常见问题:第一,第一段缺少或论点薄弱,段落从未明确承诺一个内容主张;第二,段落间流动薄弱,形成“段落孤岛”,缺少承载内容的桥接。它被触发于需要检查或润色段落逻辑、论点陈述、连接词、论证主线的场景,适用于 sections/S*.md 已存在但读起来像段落孤岛、希望在 section-merger 之前进行一次可调试的自循环修订的情况。

主要能力 技能以 Logic Editor(论证流)角色运行,要求让一个小节读起来像单一论证:第一段承诺一个清晰论点(内容主张);每段与前一段有明确逻辑关系;桥接承载内容(对比/因果/推论),而非幻灯片式叙述。约束包括:不新增引用、不更改引用键、不编造事实。编辑视角上,若某段不推进论证(主张/对比/评价/局限),则压缩或删除;若过渡为空,则改写为承载内容的桥接。

检查与阻塞规则 技能会运行检查脚本,输出 output/SECTION_LOGIC_REPORT.md,其中对论点给出 PASS/FAIL,并展示连接词统计用于诊断。阻塞项(必须修复)为:第一段缺少明确论点/要点(内容主张)。非阻塞项(仅诊断):连接词词频(如 moreover/however/therefore)。文档明确指出,计数只是段落孤岛的代理指标,若将其强制为配额,常会产生“生成器节奏”(段首副词),因此这些统计应视为信号而非目标。

输入与输出 输入包括:sections/ 目录(期望形如 S<sec>_<sub>.md 的 H3 正文文件);outline/subsection_briefs.jsonl(使用 thesis 与 paragraph_plan[].connector_phrase 作为意图);可选 outline/writer_context_packs.jsonl(优先使用,含裁剪后的锚点/对比与 must_use)。输出包括:output/SECTION_LOGIC_REPORT.md(论点 PASS/FAIL,连接词统计用于诊断);以及就地更新 sections/ 下的 H3 正文文件以修复论点/桥接(不新增引用,保持引用键稳定)。

使用方式(自循环工作流)

  1. 运行检查脚本,定位具体失败文件。
  2. 对每个失败的 H3 文件:在具体 H3 正文文件(模式 sections/S<sec>_<sub>.md)上工作;使用 outline/subsection_briefs.jsonl 作为小节论点与段落计划意图的事实来源;若可用,优先使用 outline/writer_context_packs.jsonl 以与 must_use 锚点/约束保持一致(不新增引用)。
  3. 论点(阻塞):让第一段以结论先行的论点句收尾;优先内容主张而非元叙述;避免重复开头如 This subsection argues/surveys ...。最小形态为三句(改写而非照抄):主张/张力;为何重要(协议/评估相关性);本节将如何解决(使用哪些对比/锚点)。
  4. 流动(仅在需要时修复):在段落感觉脱节处添加 1–2 个简短桥接;优先主语先行句与句中粘合(because/while/which),而非段首副词;避免 PPT 导航(Next, we ...、We now turn to ...)。
  5. 重新运行检查器,直到 output/SECTION_LOGIC_REPORT.md 为 PASS,然后继续 paragraph-curator、evaluation-anchor-checker、最终 argument-selfloop 快照与合并。

示例 论点信号(第一段):差(仅主题铺垫)Tool interfaces vary across agent systems, and many recent works explore different designs.;好(结论先行主张)A central tension in tool interfaces is balancing expressivity with verifiability; as a result, interface contracts often determine which evaluation claims transfer across environments.。差(元叙述)This subsection argues that memory is important for agents.;好(内容主张)Memory designs trade off retrieval reliability against write-time contamination, and this trade-off shows up as distinct failure modes under fixed evaluation protocols.。 桥接(避免段落孤岛):差(无关系)X does ...(第2段)Y does ...(第3段);好(明确关联)Whereas X optimizes for <axis>, Y shifts the bottleneck to <axis>; under fixed budgets, this changes whether the reported gains reflect better planning or simply more expensive search.。

完成标准 output/SECTION_LOGIC_REPORT.md 显示 - Status: PASS;任何 section 文件不含占位符(TODO/…/...)或大纲元标记(Intent:/RQ:/Evidence needs:);每个 H3 都有清晰的第一段论点;仅在流动确实断裂处添加桥接。

脚本与快速开始 快速开始:uv run python .codex/skills/section-logic-polisher/scripts/run.py --workspace <workspace>。注意:脚本是检查器,不会重写文本;连接词统计会打印用于诊断,不要“为计数器写作”,要为论证写作。

全部选项 --workspace <dir>;--unit-id <U###>;--inputs <semicolon-separated>;--outputs <semicolon-separated>;--checkpoint <C#>。

示例 默认运行:uv run python .codex/skills/section-logic-polisher/scripts/run.py --workspace <workspace>。显式输出路径(罕见覆盖;优先默认):uv run python .codex/skills/section-logic-polisher/scripts/run.py --workspace <workspace> --outputs output/SECTION_LOGIC_REPORT.md。

适用场景与限制 适用于已有 H3 小节文件、需要局部逻辑润色与论点/桥接修复的论文写作流程,尤其是引用密集但读起来像段落孤岛的小节。限制包括:不新增引用、不更改引用键、不编造事实;脚本仅做检查不重写文本;连接词统计仅作诊断,不应作为硬性配额;若主要问题是段落数量膨胀,应在本次检查后运行 paragraph-curator,它只合并相邻段落边界并保留全部文本,语义冗余仍归撰写者处理。