ux-microcopy-audit

マイクロコピー監査スキル

このスキルの動作 (最初にお読みください)

これは評価型のスキルです — 既存のコピーをレビューし、自動実行され、生成系スキル(ライターである ux-microcopy、および typography、dashboard、onboarding、コンポーネント系スキルがラベルやメッセージのためにここへ引き継ぐ)から検証ステップとして呼び出されるように作られています。

これはコピーの品質を担います。意図的な委譲事項:

• 操作的なコピー(コンファームシェイミング、偽の緊急性、罪悪感) → 意図の判定はダークパターン監査が担います。フラグを立ててルーティングします。
• コピーのアクセシビリティの詳細(代替テキストのルール、スクリーンリーダーの挙動) → アクセシビリティ監査です。このスキルは平易な言葉遣い/明確さにフラグを立て、技術的な a11y の仕組みは委譲します。

スコープの規律。 直接呼び出された場合(ユーザーがこの監査を指定した場合)、この関心事のみをレビューします — 兄弟監査を引き込まないでください。他のレンズと並走するのは、オーケストレーター(ux-design-review)または生成系スキルが docs/orchestration-policy.md の下でこれを呼び出す場合のみであり、そこではティア A — 常に関連し、自動実行に位置します。明示されたスコープが常に優先されます。

---

このスキルがデフォルトの動作と比べて変えるもの

デフォルトでは、コピーレビューは印象論的(「問題なさそう」)で部分的です — 隠れたコピー(エラー状態、空状態)を見逃し、フロー全体にわたる一貫性を決してチェックしません。このスキルは次を強制します:

1. コンテンツインベントリ — 隠れた状態を含むすべてのコピーを洗い出します。
2. 名前付きの基準 — 明確さ、簡潔さ、行動志向、一貫性、トーンの適合、包括性 — 印象ではなく。
3. 各指摘に対する書き換え案、および重大度。
4. フロー全体にわたる一貫性パス — 単一画面のレビューではできないものです。

---

監査メソッド (コンテンツインベントリ)

1. コピーをインベントリ化します。 フロー/プロダクト内のすべてのテキストを列挙します — そして隠れたコンテンツを見逃さないでください: エラーメッセージ、空状態、ツールチップ、確認、通知。
2. 以下の基準に照らして評価します。 修正を適用しやすくするため、スクリーンショット/場所を記録します。
3. 優先順位をつけます — 一度に 1 ステップずつ。ユーザーにとって最もコストが高いものから先に進めます。
4. フラグを立てるだけでなく、書き換え案を提示します。

---

基準 — 何をチェックし、違反がどのようなものか

1. 明確さと平易な言葉遣い

フラグを立てる場合: 専門用語や硬い言葉遣い、曖昧な表現、読み返しが必要なコピー。

• ❌ 「認証情報を検証できませんでした。」
• ✅ 「そのパスワードは一致しません。もう一度試すか、リセットしてください。」

2. 簡潔さ

フラグを立てる場合: 埋め草の言葉、複数文のラベル、6 語で足りる内容を 20 語で言っている場合。

3. 行動志向と具体性

フラグを立てる場合: 一般的なラベル(「OK」「はい」「送信」「開始」)、何が起こるか・なぜかを示さない CTA。

• ❌ 「送信」 → ✅ 「アカウントを作成」

4. 一貫性

フラグを立てる場合: 同じ概念がプロダクト内で異なる名称で呼ばれている(「scheduling」と「booking」)、一貫しないボタンの動詞、プラットフォームにそぐわない用語(モバイルでの「クリック」)。1 概念につき 1 用語。

5. トーンの適合

フラグを立てる場合: その瞬間にそぐわない言葉遣い — 支払いエラーでのジョーク、ウェルカムでの冷たい/機械的なコピー、セキュリティ操作でのためらい(「おそらく」)。トーンはブランドおよびその瞬間に合うべきです。

6. エラー状態と空/成功状態

フラグを立てる場合: エラーが問題は述べるが修正方法を述べていない、ユーザーを責める、またはすべて大文字を使っている。空状態が最初のアクションを教える代わりに空白になっている。成功が認められていない。

7. すべての人にとっての包括性と明確さ

フラグを立てる場合: 中立で済むところでの性別代名詞、説明的でないリンク(「ここをクリック」/「もっと見る」)、唯一のラベルとして使われているプレースホルダー。(技術的な a11y → アクセシビリティ監査。)

8. 誠実さ

フラグを立てる場合: コンファームシェイミング、作為的な緊急性、罪悪感、または紛らわしい二重否定。これを記録し、意図の分類のためにダークパターン監査へルーティングします。

---

重大度の評価

重大度	意味
Critical	コピーがブロックする、または誤解を招く — 先に進む道がないエラー、誤った操作を引き起こすラベル、操作的なコピー。
Major	実際の摩擦 — 曖昧な CTA、専門用語、同じ概念に対する用語の不一致、繊細な場面での不適切なトーン。
Minor	仕上げ — 冗長さ、少しずれているが理解はできる表現。

---

監査の出力形式

## Microcopy Audit — [Screen / Flow]
Context: [product voice · audience · the moment]

### Critical
- [Location] "current copy" → "rewrite" — why. (Criterion)
### Major
- …
### Minor
- …
### Working well ✓
- …

**Consistency notes:** terms used inconsistently across the flow.
**Top 3 rewrites:** highest-impact fixes.

最後に一貫性に関する注記と主要なリライトを記載してください — それらが、呼び出すジェネレーターやライターが実際に行動する対象です。

---

優れた監査の実行方法

1. まずインベントリを作成する。隠れた状態も含める — そこに最悪のコピーが潜んでいます。
2. フロー全体を通じた一貫性を確認する。各画面だけを個別に見るのではなく。
3. 指摘するだけでなくリライトする — より良いバージョンを示してください。
4. トーンを場面に合わせる。単一のハウススタイルに合わせるのではなく。
5. 委ねる — 操作的な意図は dark-patterns に、技術的なアクセシビリティは accessibility に。

---

よくある do/don't パターン

❌ しない	✅ する
「コピーは問題なさそうだ」	すべてのコピー（隠れた状態を含む）をインベントリ化する。基準を明示する。重大度を評価する
1 つの画面を切り離してレビューする	フロー全体を通じた用語の一貫性を確認する
修正せずに指摘する	リライトを提供する
汎用的な「OK/送信」ラベルをそのまま通す	指摘する → 動詞 + 結果
エラー/空の状態を見落とす	隠れたコピーを明示的に監査する
操作や a11y のルールを再導出する	dark-patterns / accessibility にルーティングする

---

出典のレッスン（Uxcel）

• Content Audits for UX Writing
• Ensuring Consistency in UX Copy
• 10 Microcopy Tips
• Patterns in UX Writing
• Writing Action-Based Messages
• Accessibility in UX Microcopy