ux-microcopy

UX マイクロコピー スキル

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

これは生成型のスキルです。Claude のデフォルトの UX コピーは、冗長で、気が利いているつもりで、ありきたりになりがちです（「おっと！何か問題が発生しました」、「送信」、「本当によろしいですか？」）。優れたマイクロコピーはその逆で、平易で、具体的で、さりげなく役に立ちます。表現に関わる部分、つまりトーンは文脈に依存するため、このスキルでは次のようにゲートを設けています。

1. ボイス、オーディエンス、その瞬間を定める — 祝福すべき成功状態に合うトーンは、決済エラーには合いません。
2. 常に当てはまる核心を適用する — 明瞭さ、簡潔さ、行動志向、一貫性、そして包括的でアクセシブルな言葉づかいは、すべてのコピーに当てはまります。
3. トーンを意図的に選ぶ — ブランドとその具体的な瞬間に合った語調を選びます。冗談めかした調子やロボットのような調子をデフォルトにしないでください。

その後は監査に引き継ぎます。 companion の ux-microcopy-audit、さらに accessibility（スクリーンリーダーとすべてのユーザーが理解できるコピー）と dark-patterns（コピーは誠実に説得するものであり、決して操作してはならない）です。

---

ステップ 0 — 書く前に文脈を定める

• ブランドボイス — 製品に一貫したパーソナリティ（遊び心があるか、フォーマルか、温かいか、ニュートラルか）。
• オーディエンスと言葉づかい — ユーザーが使う言葉を使います（「通勤」ではなく「乗車」）。技術リテラシーと読解レベルも考慮します。
• その瞬間 — 祝福か、日常か、デリケートか（決済／セキュリティ）、それともエラー／リカバリーか？　これがトーンを決めます。
• ロケール — 言語とプラットフォームの慣習（デスクトップでは「クリック」、モバイルでは「タップ」）。直訳を超えたローカライズ。

回答が得られないまま進める場合は、前提を明示してください。

---

常に適用する核心（どんなマイクロコピーにも当てはまること）

• 平易でシンプルな言葉。 できるだけ幅広いユーザーに向けて書きます。オーディエンスが期待しない限り、専門用語や硬い語彙は使いません。音読して確認しましょう。
• 簡潔に。 意味が保たれる範囲でできるだけ少ない語数で伝えます。約 16% は一語ずつ読み、残りはざっと目を走らせます。余分な言葉は削りましょう。
• 行動ベースで具体的に。 ラベルは結果を表す動詞（＋名詞）です —「Pro を入手」、「ファイルを削除」、「今すぐミュート解除」— 決してありきたりな「はい／いいえ／OK／送信」ではありません。優れた CTA はメリットも伝えます。
• 何が起きていて、次に何が起こるかを伝える。 不確実性を減らします。自分がどこにいるのか、その操作が何をするのか、どれくらい時間がかかるのか。
• 用語の一貫性。 製品全体で 1 つの概念に 1 つの用語（どこでも「scheduling」を使い、別の場所で「booking」にしない）。プラットフォームの慣習とも一致させます。
• 人間にわかりやすい数値と日付。 「4 月 1 日」ではなく「明日」、「9 時 15 分前」ではなく「午前 8:45」。漠然とした「たくさん」よりも具体的な数値や社会的証明。
• 包括的でアクセシブルに。 ジェンダーニュートラルな代名詞（they/them）。説明的なリンクテキスト（「もっと」ではなく「料金について詳しく読む」）。マイクロコピーは画像に埋め込まずライブテキストとして。永続的なラベル（プレースホルダーのみにしない）。完了した操作の確認。
• 誠実で、決して操作的でない。 コンファームシェイミング、偽の緊急性、罪悪感の誘発は禁止です（→ dark-patterns）。

---

トーン — ゲートされた判断（ブランド＋その瞬間ごとに選ぶ）

語調は意図的に選びます。同じメッセージでも、それぞれで異なって読まれます。1 つをデフォルトにしないでください。

トーン	使う場面	注意点
遊び心／機知	リスクの低い瞬間、軽いエラー、イースターエッグ	オーディエンスを理解すること。明瞭さを犠牲にしない
熱意／称賛	努力の途中での励まし、達成の祝福	日常的な操作を過剰に持ち上げない
温かい／親しみやすい	歓迎、日常的なガイダンス（ファーストネーム、短縮形、「あなた」）	深刻な場面では軽薄に感じられることがある
自信のある	デリケートな瞬間 — 決済、セキュリティ、データ	曖昧な表現（「たぶん」、「〜してみて」）を避ける
敬意のある／フォーマル	プロフェッショナル、規制対象、デリケートな文脈	そっけなく読まれることがある — それでも明瞭に
誠実／率直	権限／データのリクエスト	能動態を使い、意図を隠さない
簡潔	密度の高い UI、ラベル、モバイル	必要な文脈を削りすぎない

ルール：トーンはその瞬間に合わせます。決済エラーには自信のある＋明瞭な調子が求められ、ジョークではありません。

---

マイクロコピーのパターン(クイックリファレンス)

• ボタン: 動詞 + 結果。汎用的ではなく説明的に(「はい」よりも「今すぐミュートを解除」)。
• エラー/アラート: 明示的(何が起きたか)+ 建設的(どう直すか)+ 平易な言葉。問題のそばに配置する。丁寧に、責めたり全大文字にしたりしない。
• ラベル: 具体的な動詞+名詞。「OK/開始/終了」は使わない。
• プレースホルダー: ヒントや例のみ — 決して唯一のラベルにしない(入力時に消えてしまう)。
• ツールチップ: 本当に価値を加える。当たり前のことを述べない。
• 通知/プッシュ: 「これはユーザーの何の役に立つのか?」と問いかける。役立ち、押しつけがましくない。
• 空状態/成功状態: 空 = 最初のアクションを教える。成功 = 確定 + ポジティブな瞬間。

---

結果を検証する(オーケストレーション)

ハンドオフでは、各レンズをインストール可能なスキルの name で指定します。インストール済みの場合にのみ呼び出してください。インストールされていない場合、このスキル自体のコアにこれらのルールがすでに含まれています — ブロックするのではなく、それなしで進めてください。

コピーを作成または修正した後、完了と宣言するのではなく、結果を監査レンズに引き渡してください。これらは候補のレンズです — 姿勢は docs/orchestration-policy.md で設定されるか、全体を ux-design-review 経由でルーティングしてください。ここでは、**microcopy と dark-patterns は Tier A(自動実行)、accessibility は Tier B(提案)**です — 既存のデザインシステムのもとでは accessibility は使用状況の確認に絞られます。ユーザーが特定の目的でこのスキルを呼び出した場合は、その範囲を尊重してください。

• ux-microcopy-audit (Tier A) — コンパニオン監査: フロー全体にわたる明確さ、アクション指向、一貫性、トーンの適合。
• ux-accessibility-audit (Tier B — 提案。デザインシステムのもとでは絞り込み) — 平易な言葉、説明的なリンク、ライブテキスト、持続するラベル、スクリーンリーダーへの通知。
• ux-dark-patterns-audit (Tier A) — コピーが誠実に説得する: コンファームシェイミング、人工的な緊急性、罪悪感の誘導がない。

監査で指摘があがった場合は、コアに向けて解決してください: より平易に、より具体的に、適切なトーンで。

---

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

❌ Don't	✅ Do
「おっと!何か問題が発生しました。」	「変更を保存できませんでした。接続を確認して、もう一度お試しください。」
「送信」/「OK」/「はい」	動詞 + 結果: 「アカウントを作成」「ファイルを削除」
専門用語/堅苦しい言葉	ユーザーが実際に使う平易な言葉
どこでも同じトーン	ブランドとその瞬間にトーンを合わせる
支払い/セキュリティのエラーでジョーク	自信があり、明確で、安心させるコピー
「4月1日」/「9時15分前」	「明日」/「午前8:45」
ここでは「登録」、あちらでは「無料で参加」	概念ごとに一貫した用語を1つ
「詳細」リンク/汎用的なラベル	説明的に: 「料金についてもっと読む」
画像に焼き込まれたテキスト	ライブで選択可能なテキスト
オプトアウトに対するコンファームシェイミング	中立で誠実な拒否(→ dark-patterns)

---

出典レッスン(Uxcel)

• 10 Microcopy Tips
• 10 UX Writing Tones
• Writing Action-Based Messages
• Writing Problem Messages
• Patterns in UX Writing
• Accessibility in UX Microcopy