transition-weaver

过渡编织器（优先使用 LLM；不得引入新事实）

触发条件与路由

• 触发词：transition weaver、weave transitions、coherence、过渡句、承接句、章节连贯性。
• 适用场景：outline/subsection_briefs.jsonl 已存在，且你希望在起草前后确保行文连贯（通常为 Stage C5）。

目的：生成一份小巧、低风险的“过渡图”，避免相邻小节读起来各自孤立。

此技能刻意保持低风险且确定性强：

• 脚本根据相邻小节标题和简短的衔接要点生成 outline/transitions.md
• 生成的过渡内容适合用于论文，且不会引入新事实或引文

过渡句应回答：

• 前一个单元确立了什么
• 仍有哪些缺口或张力
• 为什么接下来要讲下一个单元

注入约定（将过渡内容视为草稿文本）

outline/transitions.md 不是规划笔记：section-merger 会将其注入 output/DRAFT.md。 因此，每条过渡句都必须适合直接作为论文正文阅读。

合并插入格式约定：

• 默认只插入符合 - 3.1 -> 3.2: <text> 格式的行（章节内 H3 -> 下一个 H3）。
• <text> 应写成一个不带列表格式的句子。

说明：

• 使用 ASCII 箭头 ->（而非 Unicode 箭头），以避免不可见字符或控制字符导致的编码问题。
• section-merger 为向后兼容，也接受 -> 和 →，但首选约定是 ->。

硬性规则：

• 将过渡句写成最终正文：承载内容，而非描述流程。
• 不要以规划者口吻开头：避免使用诸如“To keep ...”、“The remaining uncertainty is ...”、“setting up a cleaner ...”等句式。
• 不要使用斜杠分隔的类别标签（A / B / C；planning/memory）。改用自然的行文表达。
• 保持简短：最好一句，极少数情况下可写两句。
• 避免使用分号串联多个分句来写构建说明。

改写触发词（看到以下内容时，应进行改写）：

• “To keep ...” / “We next focus on ...” / “The remaining uncertainty is ...”
• “as the comparison lens” / “reference point” / “to make the next trade-offs easier to interpret”

角色提示词：衔接者（保持连贯，不作旁白）

You are the coherence linker for a survey.

Your job is to write short, content-bearing transitions between adjacent subsections:
- restate what was established (one clause)
- name the remaining tension/gap (one clause)
- justify why the next subsection is the right lens (one clause)

Style:
- argument bridge, not navigation
- no “Now we discuss / Next we move / In this section…”
- no semicolon planning notes

Constraints:
- NO NEW FACTS
- NO citations
- only reuse handles that already exist (titles, RQs, bridge_terms)

风格目标（符合论文风格，仍然不得引入新事实）：

• 优先使用承载内容的论证式衔接，而非叙述提纲。
• 保持简短（通常为 1 句）。
• 合并后避免复述标题：不要写“From Section A to Section B”。
• 避免使用“Now we discuss / Next we introduce / In this section we ...”。

关键：过渡句必须是有实际内容的句子，不能是构建说明。

• 不佳：“在 X 之后，Y 通过……明确建立衔接；……；从而为更清晰的 A 与 B 比较铺路。”
• 较佳：“虽然循环设计决定了哪些操作是可能的，但工具接口定义了这些操作如何落实到可执行 API 和编排策略中。”

也要避免使用（合并后读起来像分类或规划笔记）：

• 斜杠分隔的类别标签（例如 A/B/C、planning/memory）；应改用自然的行文表达（使用 和 或 或）。

输入

• outline/outline.yml（排序与标题）
• outline/subsection_briefs.jsonl（需包含 rq，可选包含 bridge_terms / contrast_hook）

输出

• outline/transitions.md（由 section-merger 使用；保持论文语气）

工作流（不得引入新事实）

1. 阅读 outline/outline.yml，确定相邻关系（哪个 H3 接在另一个 H3 之后）。
2. 阅读 outline/subsection_briefs.jsonl，提取各小节的 rq 以及任何衔接要点（bridge_terms、contrast_hook）。
3. 为每处衔接撰写 1–2 句过渡句：

• 不引入新事实
• 不添加引文
• 不明确写出“我们将本节组织如下……”等元叙述
• 不使用占位符（TODO、…、``）

4. 写入 outline/transitions.md。

角色卡（明确使用）

衔接句（论点桥梁）

目标：撰写简短、承载内容的过渡句，不加旁白。

应做：

• 用一个分句重述已确立的内容。
• 用一个分句指出尚存的张力或缺口。
• 用一个分句说明为何接下来要讲下一部分。

避免：

• 标题旁白（“从 X 到 Y”）和幻灯片导航（“现在我们转向……”）。
• 用分号写规划备注或元评论。

怀疑者（模板杀手）

目标：删除任何读起来像构建备注的内容。

应做：

• 删除适用于任何小节的通用过渡句。
• 强制使用来自标题、研究问题或衔接术语的小节专属名词。

避免：

• 在过渡句中塞入新事实。

脚本（生成器 + 验证）

通常不需要手动运行此脚本；它的作用是让流水线运行器能够确定性地生成并验证产物。

快速开始

• uv run python .codex/skills/transition-weaver/scripts/run.py --workspace <workspace>

所有选项

• --workspace <dir>：工作区根目录
• --unit-id <U###>：单元 ID（可选；用于日志）
• --inputs <semicolon-separated>：覆盖输入（少见；通常使用默认值）
• --outputs <semicolon-separated>：覆盖输出（少见；默认验证 outline/transitions.md）
• --checkpoint <C#>：检查点 ID（可选；用于日志）

示例

• 编写 outline/transitions.md 后进行验证：
  • uv run python .codex/skills/transition-weaver/scripts/run.py --workspace <workspace>

故障排除

问题：过渡句读起来像模板

修复：

• 确保小节简介包含小节专属的衔接信号（bridge_terms / contrast_hook）。
• 重写过渡句，提及这些要点（作为内容，而非轴标签列表）。

注意：插入操作需显式执行

默认情况下，section-merger 不会插入生成的过渡句。创建 outline/transitions.insert_h3.ok，用于章节内 H3 级过渡；或创建 outline/transitions.insert_h2.ok，用于 H2 级之间的过渡，然后运行合并后语气检查。