SuperAPI AI 工具集

paragraph-curator

智能体与模型

查看项目

更新于 10-16 09:48

技能介绍

用途:在 H3 章节文件通过逻辑打磨后、最终论证快照与合并之前,对段落边界进行确定性收敛,避免长时间起草循环导致章节超出交付配置。它不做新的语义重写,不排序段落、不生成替代方案、不替换证据,也不判断哪些论断重要。

主要能力:按交付配置控制每个 H3 的段落数。配置为 course_paper 5-7 段、survey 10-12 段、deep 11-13 段。脚本先合并相邻的短正文段落,同时遵守配置下限;若仍超预算,则反复合并最短的合格相邻段落对。不会截断段落,也不会丢弃中间块。

输入与输出:输入为 sections/S<subsection-id>.md、queries.md 中的 draft_profile,以及上游逻辑与写作报告作为操作上下文。仅修改 H3 文件,不触碰前置元数据(S1.md、S2.md)、H2 引导文件和全局章节。输出更新后的 H3 文件、output/PARAGRAPH_CURATION_REPORT.md,以及 PASS 时的 sections/paragraphs_curated.refined.ok 标记。报告记录当前配置和每个 H3 的前后段落数;PASS 要求每个 H3 都在预算内且引用块顺序不变,FAIL 时移除标记。

使用方式:运行 uv run python .codex/skills/paragraph-curator/scripts/run.py --workspace workspaces/<name>。可选运行字段为 --unit-id、--inputs、--outputs 和 --checkpoint。

适用场景:H3 章节已通过逻辑打磨、需要收敛到交付配置段落预算时。

限制:若 H3 低于下限,应转交 subsection-writer 或相关证据单元,压缩不得编造填充内容;若正文重复或逻辑薄弱,应转交 writer-selfloop 或 section-logic-polisher,本技能只改变段落边界而非想法。应在本技能之后运行 argument-selfloop,使论证台账和章节清单描述最终章节内容。