关于 post-merge-voice-gate
post-merge-voice-gate 是面向综述草稿合并后检查的技能,用于发现规划口吻、斜杠列举和导航式叙述。它生成检查报告,并在失败时将记录追加到质量门文件。
主要功能
- 01检查规划式过渡语
- 02检查正文中的斜杠轴标签
- 03检查幻灯片式导航叙述
- 04定位问题来源以便修正
- 05失败时更新质量门记录
适用场景
- 01section-merger 生成草稿后检查口吻
- 02转换文本被插入草稿后排查生成器痕迹
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ willoscar/ research-units-pipeline-skills --skill post-merge-voice-gate安装后在 Claude Code 中输入/post-merge-voice-gate确认已加载。
附带文件scripts/run.py
详细介绍
合并后口吻门
触发条件与路由
- 触发词:合并后口吻门、合并口吻门、过渡句污染、规划器腔调、合并后口吻门、过渡句污染。
- 适用场景:
section-merger已生成output/DRAFT.md,你希望确保合并时注入的文本不会在润色前让草稿带上生成器腔调。
目的:捕捉合并后出现的、影响最大的“自动化痕迹”。
存在原因:
- 合并可能会暴露章节正文中的规划器腔调,或明确启用的过渡句。
- 即使只有几句规划器腔调或轴标签句,也会让原本扎实的草稿读起来像生成器写的。
- 修复应落在最早的责任产物中:通常是所属章节;仅当启用了插入功能时,才修改
outline/transitions.md。
此技能是一道关卡:
- 它会生成一份报告(
output/POST_MERGE_VOICE_REPORT.md)。 - 如果检查失败(FAIL),它还会追加内容到
output/QUALITY_GATE.md,以便工作区保持可调试。
角色提示词:口吻把关员(论文口吻,不添加新事实)
You are the post-merge voice gatekeeper for a survey draft.
Your job is to detect high-signal generator voice in the merged draft:
- planner-talk transitions ("To keep the chapter...", "The remaining uncertainty is...")
- slide/navigation narration ("Next, we move...", "We now turn...")
- axis-label slash lists (A / B / C; planning/memory) used as prose
Rules:
- do not change the draft directly; route fixes to the source file
- do not invent facts or citations
- keep fixes minimal and content-bearing (argument bridges, not navigation)
Output:
- a short PASS/FAIL report with a routing plan
输入
output/DRAFT.mdoutline/transitions.md
默认情况下,outline/transitions.md 是可选的规划产物。只有在存在
outline/transitions.insert_h3.ok 或 outline/transitions.insert_h2.ok
时,才会将其视为可能面向读者的内容来源。
输出
output/POST_MERGE_VOICE_REPORT.md(始终生成)
此关卡检查的内容(仅高信号项)
- 规划器腔调的过渡句开头(读起来像论文正文中的注释的构建说明)
- 面向读者的草稿正文中的斜杠分隔轴标记(A / B / C)
- 本应作为论证衔接的幻灯片式/导航式叙述
改写触发条件(如发现以下内容,判定失败并进行路由)
这些句式一旦注入草稿正文,就是高信号的生成器腔调:
- “To keep ...” / “To keep the chapter...”
- “The remaining uncertainty is ...”
- “as the comparison lens” / “as the reference point”
- 使用
/分隔的轴标签列表(例如,“retrieval / index / write policy”)
路由规则(最早的责任产物)
- 如果已启用过渡句插入,且问题短语出现在
outline/transitions.md中:- 修复方法:重新运行
transition-weaver(或手动编辑outline/transitions.md),然后重新运行section-merger。
- 修复方法:重新运行
- 否则(短语仅出现在草稿正文中):
- 根据出现位置,路由至
writer-selfloop/subsection-polisher/draft-polisher。
- 根据出现位置,路由至
微型改写示例(请勿逐字照抄)
不佳(规划器腔调,读起来像构建说明):
To keep the chapter's comparison lens explicit, we now turn to ...
较佳(论证衔接,承载内容):
Once interface contracts fix what actions are executable, the next bottleneck is how agents choose among those actions under uncertainty and budget constraints.
不佳(轴标签斜杠列表):
... under mechanism/architecture/data trade-offs ...
较佳(自然行文):
... under trade-offs between architectural choices and the data/feedback available during interaction ...
脚本(可选;确定性关卡)
快速开始
uv run python .codex/skills/post-merge-voice-gate/scripts/run.py --workspace <workspace>
所有选项
--workspace <dir>:工作区根目录--unit-id <U###>:单元 ID(可选;用于日志)--inputs <semicolon-separated>:覆盖输入(较少使用;默认值:output/DRAFT.md;outline/transitions.md)--outputs <semicolon-separated>:覆盖输出(较少使用;默认值:output/POST_MERGE_VOICE_REPORT.md)--checkpoint <C#>:检查点 ID(可选;用于日志)
示例
- 在
section-merger之后立即运行(推荐):uv run python .codex/skills/post-merge-voice-gate/scripts/run.py --workspace <workspace>
注释
- 此脚本仅用于分析;绝不会编辑内容。
- 检查失败(FAIL)时,它会生成
output/POST_MERGE_VOICE_REPORT.md,并向output/QUALITY_GATE.md追加一条简短记录。
评论
支持 Markdown