mcpField
V
voice-review

voice-review

github.com/athola创意与媒体34378 次安装1 天前更新
代码仓库

关于 voice-review

voice-review 根据写作风格档案审阅生成内容或现有文本。它并行运行文案与写作技巧审阅，自动修复指定的严重问题，并将其他发现交由用户决定。

主要功能

  1. 01并行进行文案与技巧审阅
  2. 02检查风格偏移和禁用短语
  3. 03自动修复严重问题
  4. 04以表格呈现建议供用户决策
  5. 05核验发现是否有文本引用依据

适用场景

  1. 01检查生成文本是否符合写作风格
  2. 02使用风格档案审阅现有文档

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/athola/claude-night-market --skill voice-review

安装后在 Claude Code 中输入/voice-review确认已加载。

详细介绍

Voice Review 技能

调度双重审核 Agent，并呈现统一的审核结果。

不适用场景

  • 生成文本（使用 scribe:voice-generate）
  • 没有语气档案的通用 AI 模式扫描（使用 scribe:slop-detector）

方法：并行双重审核

两个 Agent 并行审核生成的文本：

  1. 文稿审核员：AI 模式、禁用短语、语气偏移
  2. 创作审核员：命名、目的地、描写、修辞手法、锚定

硬性失败项（禁用短语、长破折号）会自动修正。 其他内容以建议表格的形式返回，供用户决定。

必需的进度项

  1. voice-review:text-loaded - 已读取生成的文本
  2. voice-review:register-loaded - 已加载语气档案
  3. voice-review:agents-dispatched - 已启动两位审核员
  4. voice-review:hard-fails-fixed - 已应用自动修正
  5. voice-review:advisories-presented - 已向用户展示表格
  6. voice-review:findings-verified - 已由验证器确认引用

第 1 步：加载上下文

读取：

  • 生成的文本（来自文件或剪贴板）
  • 当前启用的语气档案
  • 禁用短语列表

第 2 步：调度审核 Agent

并行启动两个 Agent：

Agent(prose-reviewer):
  - text: {generated_text}
  - register: {register_content}
  - banned_phrases: {banned_list}

Agent(craft-reviewer):
  - text: {generated_text}
  - register: {register_content}

第 3 步：处理结果

硬性失败项

静默应用文稿审核员提出的所有自动修正：

  • 删除或替换禁用短语
  • 用适当的标点替换长破折号
  • 改写否定后再纠正的句式

报告：“已修正 N 个硬性失败项（X 个禁用短语、Y 个长破折号、Z 个句式模式）”

建议表格

向用户展示两个表格：

文稿审核建议：

#行锚点模式当前内容建议修正

创作审核：

维度评级备注建议改进

第 4 步：用户决定

对于每一行建议，用户可以：

  • 接受（a）：应用建议的修正
  • 拒绝（r）：保留当前文本
  • 重写（w）：应用自定义修正

按以下格式展示：

[1] Prose: Frictionless transition at "Furthermore, the..."
    Proposed: Cut transition, start mid-thought
    [a]ccept / [r]eject / re[w]rite?

第 5 步：应用决定

  • 将接受的修正应用到文本中
  • 跳过已拒绝的项目
  • 对于重写内容，纳入用户提供的版本
  • 保存最终文本

第 6 步：快照（如果已启用学习模式）

如果用户启用了学习模式：

  • 保存“审核后”快照（硬性失败项修正后、用户决定建议项之前的文本）
  • 保存“修正后”快照（用户决定后的文本）
  • 两者都保存到 ~/.claude/voice-profiles/{name}/learning/snapshots/

与 voice-generate 集成

从 voice-generate 调用时，流程如下：

  1. voice-generate 生成文本
  2. voice-generate 调用 voice-review
  3. voice-review 调度 Agent 并处理结果
  4. 用户决定是否采纳建议
  5. 如果启用了学习模式：保存快照以供日后比较

独立使用

也可用于审核任何现有文本：

/voice-review path/to/file.md --profile myvoice --register casual

验证审核结果有依据（voice-review:findings-verified）

将建议行写入 .review/findings.json，运行引用验证器 （Skill(imbue:review-core) 第 5 步），并删除验证器拒绝的条目，或将其标记为 UNVERIFIED。

验证

审核完成后，确认以下条件：

  • 两个审核 Agent 均已返回结果（没有超时）
  • 硬性失败项已自动修正，并向用户展示了差异
  • 已向用户展示建议表格及接受／拒绝／重写选项
  • 已将用户的决定应用到最终文本
  • 最终文本已保存到磁盘
  • 已保存快照（如果已启用学习模式）

退出条件

  • 两个审核 Agent 均已返回结果，没有超时
  • 硬性失败项已自动修正，并向用户展示了差异
  • 已向用户展示建议表格及接受／拒绝／重写选项
  • 已将用户的决定应用到最终文本
  • 最终文本已保存到磁盘
  • 每一行建议都带有 Line（文件:行号）和逐字引用的 Anchor； citation_verifier.py 已确认所有引用（退出码为 0），或未验证的行已删除／标记为 UNVERIFIED

测试规范

测试套件（test_voice_review.py）验证：

  • 技能文件存在，且引用了并行派发
  • 已记录硬性失败与建议性反馈的区分
  • 文案审阅 Agent 存在，且包含硬性失败模式
  • 工艺审阅 Agent 存在，且包含五个维度的评分
  • 两个 Agent 都会生成表格形式的输出，以便下游合并

评论

支持 Markdown