ux-writing

スキル：UX ライティング

ステップ 0：キットはありますか？ このスキルはキットのファイルを読み込みます。一度確認してください： ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING KIT_MISSING の場合、インストールされているのはスキルフォルダーのみです。これは npx skills add を実行した場合の状態です。その旨を明確に伝え、 npx ux-ui-agent-skills init またはプラグインのインストールを案内して、そこで終了してください。開けなかったファイルの内容を推測してはいけません。

プロジェクトの声に合わせて、インターフェースのコピーを作成または批評します。

手順

1. ${CLAUDE_SKILL_DIR}/../../../content/voice-tone.md を読みます（声の原則、トーンの段階、定型表現、マイクロコピーのパターン、インクルーシブな表現、リリース前チェックリスト）。
2. ユーザーの感情に合わせてトーンを調整します（オンボーディング／成功／日常／エラー／破壊的操作）。ストレスが高いほど、平易な言葉を使います。
3. 定型表現を適用します：
   • ボタン：動詞を先頭に置き、結果を明示します。
   • 確認ダイアログ： 確認ボタンでは操作と対象を言い直します。「削除」／「OK」／「はい」／「確認」ではなく、「アカウントを削除」とします。タイトルは問いかけ（「アカウントを削除しますか？」）、ボタンは同じ言葉で答えます。「キャンセル」はそのままにします。取り消せない操作や重大な影響を伴う操作では、入力による確認の手順を必須にします（WCAG 3.3.4/3.3.6）。
   • エラー：何が起きたか → 理由 → 解決方法（行き詰まらせず、コードやスタックトレースは表示しません）。
   • 空の状態：価値 → 最初の操作。
4. 表記ルールを徹底します：センテンスケース、すべて大文字の表記は使わない、数字は数値で記載、ユーザーを責めない、ラベルを使う（プレースホルダーは使わない）、方向や色だけに頼った説明はしない。
5. リリース前コピーの 10 項目チェックリストを実施します。

出力

自然に声に出して読め、チェックリストに合格する最終コピー（または変更履歴付きのレビュー）。文字数に厳しい制限がある UI では、その制限を守ります。

検証（完了を宣言する前に必須）

${CLAUDE_SKILL_DIR}/../../../content/voice-tone.md のリリース前チェックリストの全 10 項目を確認します。省略してはいけません：

• 声に出して自然に読めること。操作の動詞が先頭にあること。専門用語、非難、行き詰まりがないこと。
• エラーは「何が起きたか → 理由 → 解決方法」の順になっていること。空の状態では価値 → 操作を示し、「データがありません」／「エラー」だけで済ませないこと。
• 表記ルール：センテンスケース、数値表記、ラベル（プレースホルダーではない）、色や方向だけに頼らない説明、インクルーシブな表現。
• 文字数制限を守り、翻訳しやすいこと（文字列を連結しないこと。${CLAUDE_SKILL_DIR}/../../../accessibility/i18n-rtl.md を参照）。