voice-reviewer について
Voice Reviewerは、プロジェクトのボイスガイドラインやlintルールに沿ってコンテンツを監査するスキルです。文体、語句、文の長さ、バイリンガル方針、構成を確認し、違反箇所と行番号、修正案を示します。
主な機能
- 01ボイスガイドとlintルールの検出
- 02文の構造や語句の確認
- 03トーンとバイリンガル方針の監査
- 04違反箇所と行番号の報告
- 05違反ごとの修正案の提示
活用シーン
- 01ブランドボイス規則に沿った原稿レビュー
- 02バイリンガル要件の確認
- 03構成や語句の違反の特定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ genericservice/ claude-skills --skill voice-reviewerインストール後、Claude Code で/voice-reviewerを入力して読み込まれたか確認します。
詳細
ボイスレビュー担当
プロジェクトのボイスガイドラインに照らしてコンテンツをレビューします。このスキルでは、プロジェクトのボイスガイドとリントルールを読み込み、コンテンツファイルを監査して違反を確認します。
仕組み
- ボイスガイドを探す:プロジェクトのルートで、
docs/brand-voice-guidelines.md、.voice-lint.json、または類似のファイルを探します。 - ルールを読む:文の長さの上限、禁止語、トーンの要件、バイリンガルの方針、構成パターンを抽出します。
- コンテンツを監査する:各ファイルをすべてのルールに照らして確認します。
- 報告する:違反箇所を行番号、該当するルール、修正案とともに列挙します。
チェック項目
文の構成
- 文の最大長(ガイドに定められた単語数。通常は20~30語)
- 1文につき1つの観察事項
- 短縮形を優先する
- 短文から中文を使う
禁止パターン
- 最上級表現(best、top、must-visit、amazing、incredible)
- 感嘆符
- 絵文字
- 流行りのスラング(hits different、no cap、lowkey、動詞としてのvibe check)
- ハッシュタグを多用するような表現
- 形容詞の過剰な連用(cozy、intimate、must-visit spot)
- 専門家や権威を装う表現(everyone knows、locals say、the best)
トーン
- 宣伝よりも観察を重視する
- 曖昧さより具体性を重視する
- 断定よりも好奇心を大切にする
- 気取らず、人間味のある表現にする
- 「最高です」ではなく「~のように感じました」と表現する
バイリンガルの方針(該当する場合)
- EN:ESの目標比率を確認する(例:ループでは85:15、リチュアルでは95:5)
- スペイン語の挿入句は単語数の上限内に収める(通常は最大6語)
- コンテンツ全体をスペイン語で繰り返さない
- H1/H2の見出しにスペイン語を使わない
構成パターン
- 到着 -> ディテール -> 変化 -> 解放という流れ
- 説明するのではなく、描写する
- 各セクションに具体的な感覚描写を1つ以上入れる
- この段落は別の街にそのまま当てはまるか(当てはまる場合は書き直す)
出力形式
## Voice Review: [filename]
### Violations
1. **Line 23**: "This amazing, must-visit hidden gem is perfect for date night!"
- **Rule**: No superlatives, no adjective stacking
- **Fix**: "The place looks quiet until you sit down."
2. **Line 45**: Sentence is 31 words (max: 24)
- **Rule**: Max sentence length
- **Fix**: Split into two sentences.
3. **Line 67**: Spanish aside "entonces vamos a intentar algo nuevo juntos" (7 words)
- **Rule**: Spanish asides max 6 words
- **Fix**: Trim to "vamos a intentar algo nuevo" (5 words)
### Summary
- 3 violations found
- 0 critical (forbidden terms)
- 2 structural (sentence length, adjective stacking)
- 1 bilingual (Spanish aside too long)
エージェント型ワークフローとバイブコーディング
- 反復的な改良: 初回で完璧なボイスレビューができるとは限りません。まずレビュー案を作成し、ガイドラインが過度に細かく指摘することなく適切に適用されているか確認します。ルールの誤適用があれば特定し、批評を改善します。ルールの解釈は一度に1つずつ調整してください。
- バイブコーディング: 最終的なフィードバックを送る前、またはドキュメントの大規模な書き換えを試みる前に、作業中のレビュー用メモやコンテンツの変更案をローカルでコミットしてください。
サブエージェントとしての使用方法
サブエージェントとして実行する場合は、次の情報を指定してください。
- レビュー対象のファイル
- ボイスガイドのパス
.voice-lint.jsonのパス(存在する場合)
レビュー担当は、まずボイスガイドを読んでから、各ファイルを個別に監査してください。
コメント
Markdown 対応