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 Skill

2 つのレビューエージェントを並行して起動し、統合した指摘事項を提示します。

使用しない場合

  • テキストを作成するとき（scribe:voice-generate を使用）
  • ボイスプロファイルを使わずに一般的な AI パターンをスキャンするとき（ scribe:slop-detector を使用）

方法：並列デュアルゲートレビュー

生成されたテキストに対して、2 つのエージェントを並行して実行します。

  1. 文章レビュー担当：AI パターン、禁止フレーズ、ボイスのずれ
  2. クラフトレビュー担当：命名、行き先、描写、表現技法、具体性

重大な問題（禁止フレーズ、 em ダッシュ）は自動修正します。 それ以外は、ユーザーが判断できるよう、参考情報として表にまとめて返します。

必須の進捗項目

  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(prose-reviewer):
  - text: {generated_text}
  - register: {register_content}
  - banned_phrases: {banned_list}

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

ステップ 3：結果を処理する

重大な問題

文章レビュー担当からの自動修正をすべて、通知せずに適用します。

  • 禁止フレーズを削除または置き換える
  • em ダッシュを適切な句読点に置き換える
  • 否定してから訂正するパターンを書き換える

報告：「重大な問題を N 件修正しました（禁止フレーズ X 件、em ダッシュ 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：スナップショット（学習が有効な場合）

ユーザーが学習モードを有効にしている場合：

  • 「post-review」スナップショットを保存する（重大な問題の修正後、参考情報に関するユーザーの判断前のテキスト）
  • 「post-fixes」スナップショットを保存する（ユーザーの判断を反映した後のテキスト）
  • どちらも ~/.claude/voice-profiles/{name}/learning/snapshots/ に保存します。

voice-generate との連携

voice-generate から起動された場合の流れは次のとおりです。

  1. voice-generate がテキストを生成する
  2. voice-generate が voice-review を呼び出す
  3. voice-review がエージェントを起動し、結果を処理する
  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 とラベル付けします。

検証

レビューの完了後、次の条件を確認します。

  • 両方のレビューエージェントが結果を返している（タイムアウトなし）
  • 重大な問題が自動修正され、差分がユーザーに提示されている
  • 承認／却下／書き換えの選択肢とともに参考情報の表が提示されている
  • ユーザーの判断が最終テキストに適用されている
  • 最終テキストがディスクに保存されている
  • スナップショットが保存されている（学習モードが有効な場合）

完了条件

  • 両方のレビューエージェントがタイムアウトせずに結果を返している
  • 重大な問題が自動修正され、差分がユーザーに提示されている
  • 承認／却下／書き換えの選択肢とともに参考情報の表が提示されている
  • ユーザーの判断が最終テキストに適用されている
  • 最終テキストがディスクに保存されている
  • 各参考情報の行に Line（ファイル:行）と逐語的な Anchor が含まれている。 citation_verifier.py がすべての引用を確認している（終了コード 0）。または、未検証の行が削除されるか UNVERIFIED とラベル付けされている

テスト仕様

テストスイート（test_voice_review.py）では、以下を検証します。

  • スキルファイルが存在し、並列ディスパッチを参照していること
  • ハードフェイルと助言の区分が文書化されていること
  • ハードフェイルのパターンを含む文章レビュアーエージェントが存在すること
  • 5つの観点で評価するクラフトレビュアーエージェントが存在すること
  • 両方のエージェントが、後続のマージに使う表形式の出力を生成すること

コメント

Markdown 対応