mcpField
P
post-merge-voice-gate

post-merge-voice-gate

github.com/willoscar文档处理51741 次安装3 周前更新
代码仓库

关于 post-merge-voice-gate

post-merge-voice-gate 是面向综述草稿合并后检查的技能,用于发现规划口吻、斜杠列举和导航式叙述。它生成检查报告,并在失败时将记录追加到质量门文件。

主要功能

  1. 01检查规划式过渡语
  2. 02检查正文中的斜杠轴标签
  3. 03检查幻灯片式导航叙述
  4. 04定位问题来源以便修正
  5. 05失败时更新质量门记录

适用场景

  1. 01section-merger 生成草稿后检查口吻
  2. 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.md
  • outline/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