SuperAPI AI 工具集

transition-weaver

写作与研究

查看项目

更新于 10-16 05:44

技能介绍

用途:在调研或综述写作流程中,为相邻子章节生成简短的过渡句,提升行文连贯性,防止各小节彼此孤立。通常用于已完成子章节提纲、正式撰写之前。

主要能力:读取 outline/outline.yml 确定章节相邻关系,读取 outline/subsection_briefs.jsonl 提取每个子章节的研究问题及 bridge_terms、contrast_hook 等桥接线索,为每个边界写出 1 到 2 句过渡语,生成 outline/transitions.md。强调不引入新事实、不加引用、不使用占位符,也不写“本节将讨论”之类的元叙述。过渡句应回答:前一个单元确立了什​​么、还留下什么张力或空白、为何下一个单元顺理成章。

使用方式:脚本位于 .codex/skills/transition-weaver/scripts/run.py,通常由流水线调用;也可手动运行验证:uv run python .codex/skills/transition-weaver/scripts/run.py --workspace <workspace>。支持 --workspace、--unit-id、--inputs、--outputs、--checkpoint 等选项。默认情况下 section-merger 不会自动插入生成的过渡句,需创建 outline/transitions.insert_h3.ok(章内 H3 过渡)或 outline/transitions.insert_h2.ok(H2 之间过渡)后,再运行合并后的文风检查。

适用场景:综述、调研类文档在草拟前的连贯性打磨,以及合并草稿时的过渡注入。

限制:不生成新事实或引用;过渡句只应复用已存在的标题、研究问题和桥接词;格式上仅有形如 - 3.1 -> 3.2: <text> 的行会被默认插入,且文本应为一句、不使用列表格式,推荐使用 ASCII 箭头 ->;应避免斜杠式轴标签和“To keep…”等规划口吻开头。其余未在资料中说明的收费、平台与效果均暂未提供。