clarify について
clarify は ui-craft に含まれる文案レビュー用のサブスキルで、デザインや開発の作業に使います。固定のチェックリストで UI 文言を確認し、既定では編集せず提案を示します。
主な機能
- 01ボタン、エラー、空状態の文言確認
- 02フォーム補足と確認文の確認
- 03破壊的操作のラベル確認
- 04大文字・小文字、文体、表現の確認
- 05比較表で修正案を提示
活用シーン
- 01UI 文言の明瞭さと実行可能性の確認
- 02エラーに次の手順が示されているか確認
- 03依頼に応じた文案変更の適用
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/clarifyを入力して読み込まれたか確認します。
詳細
コンテキスト： このサブスキルは、より広範な ui-craft スキルを構成する視点のひとつです。ui-craft スキルもインストールされている場合は、まずその SKILL.md を読み、Discovery + Anti-Slop + Craft Test を確認してから、以下の固有の視点を適用してください。
$ARGUMENTS のコピーを明確にします。ui-craft スキルを読み込みます。
デフォルトモード：編集ではなく批評です。 Review Format の表にコピーの差分を記載してください。ユーザーが「apply」と言った場合に限り、変更を適用します。
チェックリスト — UI を確認し、該当する箇所をすべて指摘してください：
- ボタンラベル — 動詞＋目的語。「招待を送信」は「送信」より明確です。「プロジェクトを削除」は「削除」より明確です。「OK」「送信」「ここをクリック」は使わないでください。
- エラー — インラインで具体的かつ対処方法がわかる内容にします。「このメールアドレスはすでに使用されています。サインインするか、別のアドレスを使用してください。」のようにします。「問題が発生しました。」は使わないでください。
- 空の状態 — 空である理由を説明する1行と、CTAを1つ提示します。「プロジェクトはまだありません。最初のプロジェクトを作成しましょう。」のようにします。「ここには何もありません！」は避けてください。
- フォームのヒント — 入力欄の下に常時表示し、検証時にのみ表示する形式にはしません。「数字と記号を含めてください」はエラーとして送信後に表示するのではなく、補助テキストとして表示します。
- 確認メッセージ — 過去形で、主語を先に示します。「プロジェクトを削除しました。」は「プロジェクトの削除に成功しました。」より明確です。
- 破壊的な操作 — ボタンのラベルに対象の名詞を含めます。「{projectName} を削除」は「削除」より明確です。ダイアログで確認し、ボタンで確定します。
- 大文字・小文字 — デフォルトは文頭のみ大文字にします。Title Case はブランド化された製品名に限ります。すべて大文字の表記は使いません（例外：SKILL.md に記載済みの、11〜13px のカテゴリーラベル）。
- 文体 — 気の利いた表現より明確さを優先します。能動態を使い、短い文にします。自然な語を選びます（「中止する」ではなく「キャンセルする」、「開始する」ではなく「始める」）。
ノブに依存しないこと — 明確さは調整できるものではありません。CRAFT_LEVEL にかかわらず、チェックリスト全体を実施してください。
参照する資料：references/copy.md（マイクロコピーの文体とパターン）、references/accessibility.md（スクリーンリーダー向けエラーメッセージの要件）。
出力形式 — Review Format の表：
| 変更前 | 変更後 | 理由 |
|---|
影響の大きい項目を優先してください（エラーと破壊的な操作を最初に、次に CTA、その後に補助テキスト）。最後に、文体全体の変化を1段落でまとめてください。ユーザーが「apply」と言った場合は、コードを編集し、ファイルパスを付けて表を再出力してください。
次のステップ： /critique — コピーを変更すると階層も変わるため、変更後に画面を再確認します（ステップ1）。