human-copywrite

Human Copywrite

Apple Style Guide（2025年6月）からまとめた、編集スタイルと使用ガイドラインです。人が読むテキストを作成するときは、いつでもこのガイドラインを使用してください。

適用する場面

出力が人の読むテキストであれば、必ずこのスキルを適用してください。具体的には、次のような場合です。

• UI の文言とエラーメッセージ — ボタンのラベル、ダイアログのテキスト、空の状態、オンボーディングの文言です。語調と UI 用語のルールを適用してください。
• ユーザー向けドキュメント — ヘルプ記事、README、オンボーディングガイド、チュートリアルです。すべてのルールを適用してください。
• 開発者向けドキュメント — API リファレンス、SDK ガイド、人が読むコードコメントです。技術表記のルールも適用してください。
• マーケティング文 — 機能のお知らせ、ランディングページ、リリースノートです。語調、大文字・小文字の使い方、製品名のルールが重要です。
• ローカライズされたコンテンツ — 翻訳するあらゆるテキストです。国際化に関するスタイルルールを優先してください。
• Apple プラットフォームについて書く場合 — 周囲の製品が Apple 製品でなくても、Apple のハードウェアやソフトウェアは Apple が推奨する表記（iPhone、iPad、macOS、App Store）を使用してください。

ユーザー向けの文字列を含まないコードを書く場合は、このスキルを適用しないでください。関数名や変数名を書く場合も、これはコピーライティングではなく命名にあたり、別のガイドラインに従います。

基本原則

これらはすべてのセクションに共通する原則です。迷ったときは、これらの原則に従ってください。

1. 能動態、現在形、二人称を使います。 iPhone を Mac に接続できます。 とします。iPhone は Mac に接続できる場合があります。 とはしません。
2. 一般的な表現より具体的な表現を使います。 「ファイル」＞「保存」を選択します。 とします。メニューを使ってファイルを保存します。 とはしません。
3. 専門用語より平易な言葉を使います。 アクティベートする より オンにする、認証する より ログインする を使います（技術的に正確な場合を除きます）。
4. ユーザーが行う操作の主語に製品を置かないでください。 FileMaker Pro を使ってデータベースを作成できます。 とします。FileMaker Pro を使うとデータベースを作成できます。 とはしません。
5. 画面上の項目は「表示される」のではなく「現れる」ものです。 設定アシスタントが現れます。 とします。設定アシスタントが表示されます。 とはしません。
6. コードの動作を言い換えるのではなく、その理由を書いてください。 コードコメントにも適用します。
7. 製品名は表記をそのまま尊重してください。 AirPods（Airpods ではありません）、iCloud（有料プランを指す場合を除き iCloud+ ではありません）、Apple Pencil（Apple pencil ではありません）。
8. 10 以上の数字は数字で表記し、10 未満は綴りで表記します — ただし、多くの例外があります（numbers-and-dates.md）。
9. 名詞の前に置く複合修飾語はハイフンでつなぎ、動詞の後ではつなぎません — user-friendly app、the app is user friendly。
10. コードでは、関数名を動詞として使わないでください。 両方のディレクトリで ls を実行します とします。両方のディレクトリを ls します とはしません。

使い方

まず、必ずこの SKILL.md を読み、その後、現在のタスクに関連するトピックファイルを読み込んでください。単発で用語を調べる場合は、references/a-z-lookup.md に進み、そこにある案内に従ってトピックファイルを参照してください。

トピックファイル

ファイル	参照するタイミング
voice-and-tone.md	ユーザー向けの文章全般。コピーに関する判断の大半がここに記載されています。
punctuation.md	ダッシュ、三点リーダー、コンマ、コロン、アポストロフィ、引用符の使い方を決めるとき。
capitalization.md	見出し、タイトル、ボタンラベル、固有名詞に関連する用語を書くとき。
hyphenation-and-compounds.md	複合修飾語、e- と re- の接頭辞、user-friendly と user friendly の使い分け。
numbers-and-dates.md	日付、時刻、範囲、序数、割合、分数、年代、2D、4K、24/7 の表記。
units-of-measure.md	GB、MHz、mm、インチなどの表記。SI 単位と記号の一覧を掲載しています。
word-choice-and-confusables.md	affect/effect、backup/back up、login/log in、OK、email、online など、混同しやすい語句の使い分け。
abbreviations-and-acronyms.md	略さずに書く場合、ファイル形式、複数形、冠詞の使い方。URL、ISP、JPEG など、業界の頭字語も含みます。
ui-elements.md	ボタン、メニュー、シート、ポップオーバー、サイドバー、コントロールの用語。
apple-products.md	iPhone、iPad、Mac、MacBook、Apple Watch、AirPods、Apple Pencil など、Apple のハードウェア名。
apple-features-software.md	macOS、iOS、iCloud、Apple Music、Siri、AirDrop、Apple Intelligence、Genmoji をはじめとする、Apple のソフトウェア、サービス、機能。
technical-notation.md	開発者向けドキュメント：コードフォント、構文の説明、プレースホルダー。
international-style.md	ローカライズされたコンテンツや国際向けコンテンツ：ISO の国・通貨・言語コード、ISO 8601 の日付、電話番号。

A-Z 索引

特定の用語について（「backup と back up はどう使い分けますか？」など）は、references/a-z-lookup.md を開き、その項目が記載されているトピックファイルへの案内に従ってください。

注意点

gotchas.md を参照してください。最初に知っておくべき適用範囲に関する注意点として、ソースの「Writing inclusively」の章（代名詞、人を先にする表現とアイデンティティを先にする表現、blacklist/whitelist や master/slave の置き換え）は、このスキルの取り込み時に意図的に除外されています。

出典

Apple Style Guide、2025年6月（243ページ）。必要なトピックを選択して読み込めるよう、内容を抽出し、トピックごとに再構成しています。転載箇所では、ソースの内容をそのまま保持しています。ガイドのウェブ版は https://support.apple.com/guide/applestyleguide/welcome/web にあります。