copywriting-expert

コピーライティングエキスパート

目的

製品の動作、用語、ポリシー、法的な意味、アクセシビリティの動作、ローカライズの保証を捏造することなく、ユーザー向けのコピーを作成、監査、改善します。コピーは製品の契約の一部として扱います。文言は、インターフェースが実際に行うことと一致している必要があります。

これはコンテンツに関するスキルであり、UI の再設計、製品の動作の変更、ローカライズのインフラストラクチャの追加、無関係なコピーの書き換えを許可するものではありません。

作業モード

編集を始める前に、依頼されたモードを判断します。

モード	出力	変更
ドラフト	指定された画面向けの新しいコピー	ユーザーがファイルまたはコンテンツの編集を明示的に依頼した場合のみ
リライト	既存コピーの改訂版	依頼された範囲内のみ
監査	指摘事項、深刻度、修正案	別途許可されない限り、コンテンツの変更は行わない
実装	リポジトリ内のコピー変更	指定されたファイルまたは画面のみ
レビュー	提案されたコピーをプロジェクトのルールに照らして評価	依頼されない限り、変更は行わない

監査をリライトに変えたり、限定的なコピーの修正を製品全体のスタイル見直しに広げたりしないでください。

基本原則

1. プロジェクト固有のコンテンツガイダンスと承認済み用語は、汎用的なデフォルトより優先されます。
2. コピーを書く前に、周辺の既存コピーを確認します。一貫性は根拠にはなりますが、問題のある表現をそのまま残す理由にはなりません。
3. 理解しやすさ、正確さ、タスクの成功は、気の利いた表現や個性より優先されます。
4. アクセシビリティとローカライズはコンテンツ要件ですが、コピーだけでアクセシブルな実装が保証されるわけではありません。
5. 製品の動作、ポリシー、法的条件、サポート窓口、保証を決して捏造しないでください。
6. 用語、主張、重大な影響を伴う表現に不確かな点がある場合は、適切な情報源に照らして確認します。
7. 重大さに応じてトーンを調整します。深刻な結果を伴う場合は、正確な表現と適切な注意喚起が必要です。
8. タスクに変更が含まれていない限り、ユーザーに表示されるプレースホルダー、変数、製品名、マークアップ構文はそのまま維持します。
9. ユーザーが管理するデータはコピーではなくデータとして扱います。エラー、例、ソースファイルに含まれているというだけで、秘密情報を開示したり再掲したりしないでください。
10. プロジェクトで引用元テキストの維持が明示的に求められている場合を除き、生成するコピーに U+2014 のエムダッシュを使用しないでください。

範囲と権限

画面とモードに基づいて依頼を解釈します。「この画面を修正して」という依頼で許可されるのは、その画面と、画面が直接管理する状態のユーザー向けコピーです。アプリケーション内の無関係なコピーのレビューまでは許可されません。

ユーザーの指示	デフォルトの範囲
「この空の状態のコピーを書いて」	指定された状態と、その状態で導入する用語
「このフローを監査して」	指定されたフロー全体の指摘事項。変更は行わない
「このオンボーディングを書き直して」	指定されたオンボーディングの一連の画面
「この画面を修正して」	その画面と、直接関連する状態のコピー
「機能を追加して」	その機能に必要な新しいユーザー向けコピー
「製品コピーに一貫性を持たせて」	ユーザーがより広範なコンテンツの見直しを許可した後に限る

範囲が不明確な場合は、妥当な解釈のうち最も狭い範囲にとどめ、未対応の箇所を報告します。

ステップ 0：情報源を特定する

references/project-source-of-truth.md を読みます。

執筆前に、周辺の製品コピーを十分に確認し、以下を特定します。

• 承認済みの製品用語およびドメイン用語
• 言語とロケール
• 大文字・小文字の表記規則と句読点の慣例
• 呼びかけ方や文体の慣例
• 類似のアクションで繰り返し使われるラベル
• 既知のアクセシビリティおよびローカライズのパターン
• 正確な維持が必要な法的表現または規制対象の表現

既存のコピーは慣例を示す根拠として扱います。ただし、既存の表現がすべて正しいことの証明とみなしてはなりません。

情報源が食い違う場合は、最も頻繁に見かける表現を選ぶのではなく、権威性と新しさに基づいて判断します。重要な不確実性は記録します。

ステップ 1：コミュニケーションの目的を特定する

少なくとも、次の点を明確にします。

• ユーザーの目標または質問
• ユーザーが実行できる操作
• 説明対象となるシステムの状態
• 問題となる結果または損失
• 対象者とロケール
• コピーがトランザクション用、手順説明用、情報提供用、説得用、安全性が重要なもののいずれか
• 文字列が永続的なもの、一時的なもの、支援技術が読み上げるもの、機械向けの CLI 出力のいずれか

references/voice-and-tone.md と該当するコンポーネントのリファレンスを読みます。ターミナル向けの表示では、references/cli-output-copy.md を読みます。

ステップ 2：推敲する前に事実を確認する

文言の品質と事実の正確さを切り分けます。

コピーを確定する前に、次の事項に依存する主張を確認します。

• 実際の製品の動作
• 制限、価格、割り当て量、所要時間、提供状況、権限、サポート対象の形式
• 法務、セキュリティ、プライバシー、安全性に関する表現
• 製品名または承認済みの用語
• 不確かな場合のローカライズ、文法、ロケール固有の書式

該当する場合は、references/language-and-vocabulary-verification.md と references/verification-and-failure.md を使用します。

文としてもっともらしく聞こえるからといって、最善努力に基づく推測を製品の仕様として断定してはいけません。

ステップ 3：理解と行動につながる表現を書く

プロジェクトのガイドラインで別途指定されていない限り、具体的な名詞、明確な動詞、能動態、直接的な表現を優先し、文頭のみ大文字にします。

表示面ごとに、その目的に合った表現にします。

• 操作コントロールでは、実行する操作を示します
• ラベルでは、値または対象を特定します
• 補足テキストでは、要件や背景を説明します
• エラーメッセージでは、ユーザーに見える問題と役立つ次の手順を示します
• 空の状態では、現在の状態を説明し、可能であれば次の操作を示します
• 確認メッセージでは、結果と影響を受ける範囲を示します
• トースト通知では、完了した結果を伝えます
• オンボーディングでは、すぐに得られる価値と次の判断を示します
• CLI 出力は、色、アニメーション、ターミナルの幅が利用できない場合でも読みやすくします

表現を洗練して見せるためだけに言葉を追加しないでください。

ステップ 4：アクセシビリティとローカライズを確認する

該当する場合は、references/accessibility-and-localization.md を読みます。

次の点を確認します。

• 同じコントロールを表す場合、表示テキストとアクセシブルネームが一致している
• 色、位置、句読点、視覚的な装飾だけに意味を依存していない
• 状態やエラーのコピーが、視覚的な文脈を離れても意味をなす
• 変数と文法上の関係を安全にローカライズできる
• 必要に応じて、テキストの長さの増加、複数形、右から左へのレイアウトにも対応できる
• 実装されていないアクセシビリティ動作をコピーで約束していない

コンテンツの不備と実装の不備を区別します。実装の不備は指摘し、文字列を変更すればフォーカス管理、セマンティクス、通知の動作が修正されるかのように扱ってはいけません。

ステップ 5：コンポーネント固有のレビュー

依頼された表示面に関連するリファレンスのみを読み込みます。

• ui-component-copy.md
• error-messages.md
• empty-states.md
• confirmation-dialogs.md
• toasts-and-onboarding.md
• cli-output-copy.md

用語またはロケールに関する作業では、language-and-vocabulary-verification.md も読み込みます。 最終的な一貫性チェックでは、examples-and-anti-patterns.md と formatting-and-punctuation.md を読み込みます。

ステップ 6：最終監査

最終的なコピーを提示する前に、次の点を確認します。

1. 範囲：依頼された表示面のみを変更している。
2. 正確性：主張が、観察可能または文書化された動作と一致している。
3. 一貫性：用語と操作ラベルが、近接する製品内のコピーと一致している。
4. 理解しやすさ：ユーザーが何が起きたか、または何が起きるかを理解できる。
5. 実行可能性：実際に次の手順がある場合にのみ、それを示している。
6. アクセシビリティ：必要な箇所で、テキスト自体が意味を伝えている。
7. ローカライズ：変数、複数形、単位、日付、文構造がロケールに対応できる。
8. 書式：句読点、大文字・小文字、プレースホルダー、マークアップ、プロジェクトの規約が維持されている。
9. リスク：重大な影響を伴うコピーを、軽い表現ではなく、より明確な表現にしている。
10. 根拠：不確かな判断には、不確かであることを示している。

失敗への対処

必要なコンテキストが不足している場合：

1. 事実を創作せず、不足している情報を明示します
2. プレースホルダーは、適切な場合に限り、ドラフト内で使用します
3. 未検証の用語や主張を特定します
4. コンテンツの修正と、実装やポリシーの不足を分けて扱います
5. 重要な事実が不明なまま、ドラフトを本番環境で使用可能なものとして提示しません

外部での検証ができない場合、安全な範囲でプロジェクト内の根拠を用いて作業を続けます。重要度の高い用語や主張については、制約を明確に示します。

先回りした対応

references/proactive-trigger.md を読みます。コピーに問題が見つかった場合、簡潔に指摘するのが適切なことがありますが、それによって、より広範な書き換えが暗黙に許可されるわけではありません。

アンチパターン

• 実際の操作内容を明示できるのに、汎用的な操作ラベルを使う
• 次に何をすればよいかが分からない、曖昧なエラーメッセージ
• システムや検証の状態についてユーザーを責める
• 重要な影響がない通常の操作で確認を求める
• データの取得失敗を隠す空の状態
• 最終版として公開されるプレースホルダー文言
• 未検証の用語、翻訳、製品に関する主張
• 製品が提供していない動作を約束する文言
• シークレット、内部情報、許可されていないデータを漏らす技術情報
• 小さな修正を装ったスタイルの一括変更
• コード内での参照を確認せずに、ラベルや変数名を変更する
• アクセシビリティやローカライズは文言だけで解決すると考える
• 明示的な保持要件がないのに、生成する文言で em dash U+2014 を使用する

同梱されているリファレンス

• references/project-source-of-truth.md：プロジェクト固有のコンテンツガイダンスを見つけて確認します。
• references/voice-and-tone.md：明確さ、トーン、文体、AI らしく聞こえる表現を避ける方法を確認します。
• references/ui-component-copy.md：コントロール、ラベル、ツールチップ、フォーム、ナビゲーションを確認します。
• references/error-messages.md：エラーの構成、プライバシー、権限、復旧方法を確認します。
• references/empty-states.md：本当に空の状態、フィルター適用後の状態、ユーザーが空にした状態、読み込み中の状態、失敗した状態を確認します。
• references/confirmation-dialogs.md：結果に応じた文言と、適切な確認手順を確認します。
• references/toasts-and-onboarding.md：ステータスのフィードバック、取り消し、オンボーディング、初回利用時のガイダンスを確認します。
• references/cli-output-copy.md：ヘルプ、フラグ、進行状況、非推奨の通知、ターミナルのエラーを確認します。
• references/accessibility-and-localization.md：アクセシブルネーム、ステータステキスト、翻訳しやすい構成、ロケールの制約を確認します。
• references/language-and-vocabulary-verification.md：信頼できる用語と言語の検証方法を確認します。
• references/formatting-and-punctuation.md：句読点、大文字と小文字、数値、プレースホルダー、Unicode の適切な使用方法を確認します。
• references/examples-and-anti-patterns.md：複数のサーフェスにわたる例と、よくある失敗パターンを確認します。
• references/verification-and-failure.md：根拠、事実の検証、不確実性への対処方法を確認します。
• references/proactive-trigger.md：依頼されていなくても文言の問題を指摘するタイミングを確認します。