opener-variator

用途

Opener Variator 用于修复一种高信号的自动化痕迹：许多 H3 小节以相同的修辞形状开头，或者用“概览”式旁白替代了承载内容本身的框定。该技能定位刻意保持狭窄，只改写被标记 H3 文件的第一个段落（或前 2–4 句），同时保留原有的论证推进与引用不变。

触发词包括：opener variator、opener rewrite、rewrite openers、overview opener、开头改写、小节开头、去overview、去旁白。

主要能力

• 将被点名的 sections/S*.md 列表作为本次处理范围的唯一依据。
• 删除高信号旁白，例如“This section/subsection provides an overview …”“In this section/subsection, we …”“This subsection surveys/argues …”“Next, we move/turn …”以及重复的开头标签（如“Key takeaway:”刷屏）。
• 用某一种“开头动作”（opener move）替换，每个 H3 只选一种：
  1. Tension-first：陈述真实取舍，说明其为何重要，以论点收尾。
  2. Decision-first：框定构建者在约束下的选择，以论点收尾。
  3. Failure-first：从一个引出该视角的失败模式切入，以论点收尾。
  4. Protocol-first：从可比性约束（预算/工具可及性）切入，以论点收尾。
  5. Contrast-first：以 A 与 B 对比句开头，再解释原因，以论点收尾。
  6. Lens-first：陈述本章视角，再收窄到本小节的问题。
• 建议采用 best-of-3 开头采样：起草 2–3 个候选开头段落（不同开头模式），保留最能承载内容且在不同 H3 之间重复度最低的那一个。

使用方式

工作流从自循环报告路由：

1. 打开 output/WRITER_SELFLOOP_TODO.md，定位 ## Style Smells。
2. 将被标记的 sections/S*.md 列表视为本次处理范围。
3. 对每个被标记文件：可选地在 outline/writer_context_packs.jsonl 中查找其条目，读取 opener_mode / tension_statement / thesis 以保持对齐；实际改写上游在 subsection-writer 或 chapter-lead-writer 中完成，不要依赖盲目的本地正则替换。
4. 重跑 writer-selfloop，确认 Style Smells 列表缩小。

脚本调用：

快速开始： uv run python .codex/skills/opener-variator/scripts/run.py --workspace <workspace>

全部选项：

• --workspace <dir>（必填）
• --unit-id <U###>
• --inputs <semicolon-separated>
• --outputs <semicolon-separated>
• --checkpoint <C#>

示例（在调研工作区重写开头）： uv run python .codex/skills/opener-variator/scripts/run.py --workspace workspaces/survey-llm-agents

适用场景

• 调研/综述类稿件的 H3 小节开头改写与去重复。
• 在 style-harmonizer 之后、逻辑润色之前进行的定向处理。
• 作为认证适配器：在最新 writer-selfloop 报告仍点名被标记文件、或早于任何 sections/*.md 文件时，脚本拒绝生成标记；通过后标记会记录经过认证的 Section 树 SHA256。

角色提示（论文语气）

你是改写综述小节开头段落的编辑。目标是用承载内容的框定替换旁白/概览式开头，并在各小节间变化开头节奏，使论文读起来像有人撰写。约束：不编造事实、不添加/删除/移动引用键、不改变小节论点。检查清单：第 1 句承载内容（张力/决策/失败/协议/对比），而非“我们在本节做什么”；第 1 段以清晰的论点/结论收尾；不含幻灯式导航语。

输入输出

必需输入：output/WRITER_SELFLOOP_TODO.md（Style Smells 部分）以及所引用的 sections/S<sub_id>.md 文件。 可选输入：outline/writer_context_packs.jsonl（使用 opener_mode、tension_statement、thesis）。 输出：更新后的 sections/S<sub_id>.md 文件（仍为纯正文，无标题）。

完成清单

• 没有被标记文件以“overview/narration”句式开头。
• 第 1 段以论点/结论（含义不变）收尾。
• 引用键保持不变（无增删移动）。
• writer-selfloop 仍然 PASS，且 Style Smells 缩小。

限制

该技能范围狭窄，只改写被标记文件的第一个段落（或前 2–4 句），不改动小节论点与引用。资料未提供收费、价格、平台兼容性等其他信息，暂未提供。