SuperAPI AI 工具集

draft-polisher

通用与其它

查看项目

更新于 10-16 01:48

技能介绍

用途:对已有初稿 output/DRAFT.md 做本地润色,把脚手架式文字改成可读的综述散文,同时不破坏证据契约。触发词包括 polish draft、de-template、coherence pass、remove boilerplate、润色、去套话、去重复、统一术语。

主要能力:分三轮进行——第一轮小节润色与去模板(删除生成器口吻、导航句、标题叙述,改为承载内容的论证过渡);第二轮术语规范化(一个概念一个名称,标题、表格与正文一致);第三轮全局冗余削减(删除跨节重复的引言与结尾)。同时做引用形态规范化(合并相邻引用块、去重键、避免句尾堆砌)与量化声明卫生(保留数字时须同句给出任务、指标定义与约束)。

硬性规则:引用键不可增删;不得跨 ### 小节移动引用;不得超出证据强度夸大表述;若需跨小节重构,应回到 outline/briefs/evidence 上游处理。

使用方式:uv run python .codex/skills/draft-polisher/scripts/run.py --help;uv run python .codex/skills/draft-polisher/scripts/run.py --workspace <workspace>。可选参数 --unit-id、--inputs、--outputs、--checkpoint。首次运行生成基线 output/citation_anchors.prepolish.jsonl;仅在有意接受引用漂移时删除该文件后重跑。

适用场景:初稿读起来像脚手架、需要全局审阅或转 LaTeX 前的连贯性检查。限制:若主要问题是章节累积导致的结构性冗余,应先用 paragraph-curator 在上游处理;润色前若尚未获得写作批准,需先在 DECISIONS.md 记录相应批准。验收要求无 TODO/TBD/FIXME、无省略截断、无跨小节引用漂移、每个 H3 至少有一段含两个以上引用的跨论文综合。