better-writing

より良い文章を書く

文章を明快で、忠実かつ具体的にし、構成を整え、書き手自身の文章だと分かるものにします。

依頼の種類を見極める

文章に手を加える前に、作業の種類を選びます。

作業	使用する場面	主な参考資料
Draft	メモ、根拠、概要から新しい文章を作成する必要がある場合	references/operating-contract.md、references/genre-modes.md
Rewrite	草稿があり、構成や表現を変更できる場合	references/revision-pass-stack.md、references/quality-gates.md
Line edit	全体の構成は適切で、文の明快さ、リズム、簡潔さを整える必要がある場合	references/foundations.md、references/voice-and-rhythm.md
Review	書き直した成果物ではなく、診断やコメントを求められている場合	references/quality-gates.md
Humanise	文章が凡庸で、機械的に滑らかすぎる、型にはまっている、または作者らしさに欠けると感じられる場合	references/ai-isms-and-humanisation.md、references/genericity-and-stiffness.md。明示的に避ける表現や定型句が多い場合は、references/formulaic-language-catalogue.mdも追加します
Adapt	内容を維持したまま、読者、ジャンル、媒体、長さ、文体を変える場合	references/genre-modes.md、references/style-bundles.md

複数の作業が必要な依頼では、複数の種類を組み合わせられます。参考資料は、問題に応じた指針が必要なときに参照できます。必ずすべての資料に目を通す必要はありません。作業範囲を明確にしてください。コードの修正とエラーメッセージの書き直しを組み合わせた依頼では、このスキルでユーザー向けの文言を修正することはできますが、周囲のソース、構文、コードの動作は変更しません。文体や語法のルールに合わせるために、コードの構成要素の名前を変更したり、書き換えたり、解釈し直したりしてはいけません。ドキュメントに自然言語と機械可読な内容が混在している場合は、自然言語の文章だけを編集し、機械可読な内容はそのまま維持します。

emダッシュ、セミコロン、コロンを削除、置換、制限、または統一する明示的な依頼がある場合は、references/punctuation-and-sentence-flow.mdを読みます。この資料は必要な場合にのみ参照してください。通常の文章編集や人間らしさの調整だけで、句読点を禁止する必要はありません。

技術文書やWiki項目では、ドキュメントの慣例に注意が必要な場合はreferences/technical-documentation-and-wikis.mdを、ページの構成が不明確な場合はreferences/genre-modes.mdを参照します。適用するGoogle開発者向けドキュメントの指針よりも、リポジトリや組織のスタイル、地域設定、正確な用語、公開先の制約を優先してください。

コードのみの実装、単独のファクトチェック、著者の判定には、別のワークフローを使用します。これらの作業と並行して作成された文章の書き直しはできますが、各作業自体を行うわけではありません。

作業の進め方

編集の範囲とリスクに応じて、必要な工程だけを選びます。文の修正なら、依頼を理解したらすぐに編集し、原文と比較できます。大幅な書き換えでは、構成、根拠、文体、仕上がりの確認が必要になることがあります。以下の項目は、役立つ順に並んだ選択肢であり、8つすべての工程を必須とするものでも、工程ごとの成果物を求めるものでもありません。どの作業でも、忠実さとユーザーが求める出力を必ず守ります。

1. 執筆の前提を確認する

提示されたコンテキストから、すでに決まっていることを推測します。次の点を確認します。

• 読者、成果物、目指す結果
• 資料と事実の根拠
• 必要な長さ、形式、ロケール、ハウススタイル、期限
• ユーザーが求めているもの（草稿、書き直し、レビュー、人間らしい表現への調整、または用途に合わせた改変）
• 許容される変更の範囲

既存の草稿については、事実、数値、日付、名前、引用、出典、コマンド、パス、API 識別子、法的または技術的な用語、明示された不確実性、書き手の声を担う表現を守ります。複雑さや影響の大きさ、引き継ぎの必要性から、原文と直接照合するだけでは不十分な場合に限り、保持項目の一覧を作成します。

不足している選択肢によって結果が大きく変わる場合に限り、質問します。資料にない根拠、経験、承認、顧客の言葉、確信を決して捏造しません。

根拠のない称賛やマーケティング上の主張を、事実として変えてはならない要素と見なさないでください。曖昧な主張を取り除いた結果、書く内容がほとんど残らない場合は、同じ抽象表現を並べ替えるのではなく、根拠が不足していることを伝えるか、不足している仕組みについて質問します。

資料が機微な内容を含む場合、制約が多い場合、共同作業を伴う場合、または重要な詳細が失われるおそれがある場合は、references/operating-contract.md を読みます。

完了条件： 読者、目的、編集の自由度、資料の根拠、保護すべき要素が把握できているか、明示的に不明とされています。

2. 書き直す前に問題を診断する

問題を適切な単位で特定します。

• 文書全体：ジャンル、対象読者、順序、主張、または範囲が適切でない
• セクション：手順、根拠、展開、または判断が欠けている
• 段落：複数の役割が混在している、要点が埋もれている、繰り返しがある、つながりが弱い
• 文：主語が不明瞭、抽象的、冗長、単調、または強調が不適切
• 表記：文法、スペル、句読点、書式、またはハウススタイル

すでにうまく機能している部分は保ちます。すべての文を変更できると示すことが、よい編集なのではありません。

完了条件： 責任を持って修正すべき最小の単位と、草稿の最も優れた要素を特定できています。

3. 文体より先に構成を整える

構成の変更が対象に含まれる場合は、読者と求められた形式に合った構成を選びます。references/genre-modes.md の構成はあくまで基本例であり、固定のテンプレートではありません。各セクションと段落に明確な役割を持たせます。読者が、なぜその情報があるのか迷わないように、根拠を順序立てて示します。

ドキュメントや Wiki では、ページのスタイルを整える前に、読者、開始時の状態、標準用語、到達点を定めます。見出し、手順、リンク、アクセシビリティ、幅広い読者に伝わる明瞭さ、保守の範囲については、ドキュメント向けのリファレンスを使います。

大幅な構成変更、より自然な流れ、または密度が高すぎる文章、テキストの壁のような文章、細切れすぎる文章の修正が求められる場合は、references/natural-structure-and-digestibility.md を読みます。掲載されている変換例を参考にし、長さを機械的な基準にするのではなく、役割が変わる箇所で文章を分けます。

レビューのみが求められている場合は、書き直しは行いません。問題を診断し、該当箇所を正確に示し、読者への影響が大きい順に課題を並べ、書き直し案を提示する場合は、例として明確にラベルを付けます。

完了条件： 冒頭で適切な前提を示し、中盤で内容を繰り返さずに話を進め、結びでそのジャンルに求められる本来の役割を果たしています。

4. 該当する単位で明瞭さを編集する

複雑な修正には、references/revision-pass-stack.md に推奨する編集順序が記載されています。価値を加えない編集工程は、統合するか省略してください。

1. 段落の見直し： 各段落の役割を一つに絞り、論理の流れを明確にし、主張の重複をなくし、主張を裏付ける根拠をその主張の近くに配置します。
2. 文の見直し： 主体と動作を明確にし、具体的な名詞と動詞を使い、関連する語句をまとめ、誠実な限定を加え、強調には情報を持たせます。

すべての文を圧縮する必要はありません。ページが断片的なメモのように読めるようになったら、文と文をつなぐ表現を補ってください。長い文章を組み替える必要がある場合は、情報の実際の構造に合わせて段落、リスト、見出し、表を選びます。書式を整えても、論理の代わりにはなりません。

句読点を編集する場合は、記号を変更する前に、文と文の関係を分類してください。コロンは後に続く内容への予告を果たし、セミコロンは密接に関連する独立節のバランスを取ります。接続詞や従属節は、句読点だけでは暗黙のままになる論理を明示する必要があります。コード、URL、時刻、比率、引用、ラベル、設定に含まれる句読点は変更しないでください。

完了の基準： 読者が下書きの意味やリズムを損なわずに、初読で議論や手順を追えること。

5. 声と具体性を取り戻す

姿勢、リズム、文の展開、音読時の修正には references/voice-and-rhythm.md を使います。サンプルや明示された特性をもとに声を調整する際は、存命の作家特有の表現を模倣せず、references/style-bundles.md を使います。

人間らしさは、判断、選択、細部、立場から生まれます。わざとらしい誤字、無作為な俗語、装飾的な悪態、作り話の逸話、無理にくだけた表現から生まれるものではありません。

完了の基準： 文章に明確な視点があり、文の展開が考えの流れに合っていて、書き手ならではの印象的な細部が保たれていること。

6. 必要に応じて、定型的な表現を診断します

定型的な表現が実際に問題となっている場合は、それによって何が見えにくくなっているかを特定します。根拠のない利点をうたう表現や、行為者、仕組み、根拠、結果を隠す定型句を持ち込まないでください。一般的な単語、句読点、丁寧さ、意図的な修辞そのものは欠点ではありません。

人間らしさを高める依頼や、定型的な表現についての明示的な依頼では、診断に迷う場合は references/ai-isms-and-humanisation.md を、表現パターンの例や例外を確認する場合は references/formulaic-language-catalogue.md を参照してください。文を編集するというだけの理由で、両方を読み込まないでください。

カタログの対応レベルは、禁止事項ではなく、文脈に応じた診断基準として扱います。

• 役に立つ機能を加えていない中身のない枠組みや演出上の指示は削除します
• 定型的な意味の枠組みが意味を見えにくくしている場合は、一度しか使われていなくても、裏付けのある意味に基づいて書き直します
• 一般的な単語や構成上の目印は、文脈やまとまりの中で確認します
• 意図的な修辞や正当なジャンル上の慣例も含め、文字どおりの用法、技術上の用法、法的な用法、測定値に関する用法、引用、執筆者自身の表現を保護します

回避ルールを満たすためだけに類義語へ置き換えないでください。これは、個々の注意語だけでなく、カタログ全体に適用されます。Bridge the gap を close the divide に置き換えてはいけません。何が不足していて、どのような行動によって変化するのかを特定してください。Marks a significant shift を signals a major transformation に置き換えてはいけません。変化の前後を明示してください。Plays a critical role、unlocks value、research shows についても同様に、裏付けのある行動、結果、または出典が必要です。必要な内容が原文にない場合は、その主張を削除するか、範囲を狭めるか、確認を求めてください。

ファイルに基づく草稿で、繰り返し現れるパターンの特定が問題解決に役立つ場合は、任意で次を実行します。

python3 scripts/scan_aiisms.py path/to/draft.md

自動処理には --format json を使い、--gate は複数パターンがまとまって現れる場合の保守的なゲートとしてのみ使用します。通常のスキャンでも、削除、書き直し、確認のラベルが付いた単独の一致は表示されます。一致箇所は例外に照らして判断してください。スキャナーでは、その用法が文字どおりか、ジャンルに適しているか、執筆者自身の表現かは判断できません。ダッシュ、洗練された文、一般的な単語は、文脈として捉え、問題の証拠とはみなさないでください。

指摘された語句だけでなく、考えそのものを書き直してください。方言、アクセシビリティ上の選択、第二言語話者らしい文体、引用、文字どおりの専門用語、意図的な修辞は保ってください。

完了の条件： 削除・書き直しルールへの対応が済んでいるか、意図的に残されており、確認のみの対象となるまとまりは文脈の中で判断され、改稿が「検出されにくくなった」だけでなく、通常の編集基準でも読みやすくなっていること。

7. 成果物を調整します

対象となるジャンル、読者、地域、ハウススタイルに合わせます。見出し、リスト、行動喚起、例、締めくくり方を確認します。内容に見合った分量の書式を使い、すべての段落に見出しを付けたり、すべての考えを箇条書きにしたりしないでください。

ドキュメントや Wiki ページでは、該当する箇所に変更があった場合、references/technical-documentation-and-wikis.md の関連チェックを使用します。定着している地域やプロジェクトの慣例を、Google 固有の好みに置き換えないでください。

完了の条件： 事実や個人的な特徴を失うことなく、成果物が提出先に自然になじむ見た目と文体になっていること。

8. 原文と比較して、作業を終えます

変更した文章は必ず原文と照合し、依頼された形式になっているか確認します。対象範囲が広い場合やリスクが高い場合は、references/quality-gates.md から関連するチェックを選びます。

1. 忠実性
2. 論理と根拠
3. 明瞭さとリズム
4. 声と人間らしさ
5. ジャンルと表記
6. 最終校正

改稿を原文および使用した記録と照合します。診断結果を根拠にする場合、その結果が無効になり得る変更を行った後は、再度確認してください。スキャンは、あらゆる作業の完了条件ではありません。残る変更が「違う」だけで「より良い」ものではなくなった時点で、作業を終えます。

完了の条件： 該当するすべてのゲートを通過し、保護対象の内容が原文と一致し、把握している重大な問題が残っていないこと。

出力契約

依頼された成果物またはレビュー結果を最初に提示します。ユーザーが編集記録を求めていない限り、作業メモは簡潔にします。必要に応じて、次の内容を報告します。

• 重要な構成上の選択
• 保護した事実や文字列
• 未解決の事実確認事項
• 診断シグナルに対する意図的な例外

文章が AI によって書かれたと断定しないでください。文体上の好みを非難にすり替えないでください。

ガイダンスが不十分な場合

重要な用法、ドキュメントの慣例、または事実の根拠が古くなっている場合や、このガイダンスと矛盾する場合は、該当する組織のスタイルガイド、最新の一次資料、または信頼できる編集資料を確認してください。ユーザーに認められた編集範囲内で、確認済みのガイダンスを使用してください。解決していない点は推測せず、明示してください。典拠となるスキルのソースに修正を提案する際は、参照元と変更前後の例、または回帰チェックを添えてください。日常的な編集ではウェブを検索せず、インストール済みのスキルのコピーを黙って変更しないでください。

クイックリファレンス

必要な内容	参照または実行
ブリーフ、保持項目の記録、編集の自由度	references/operating-contract.md
任意の改訂パスと繰り返し処理	references/revision-pass-stack.md
自然な構成、段落構成、長文の読みやすさ	references/natural-structure-and-digestibility.md
文法、明瞭さ、現代的な用法の基準	references/foundations.md
リズム、姿勢、声調の調整	references/voice-and-rhythm.md
ダッシュの置き換え、セミコロンとコロンの判断、文の流れの修正	references/punctuation-and-sentence-flow.md
画一的、企業的、儀礼的、または大げさな文章	references/genericity-and-stiffness.md
AI らしいパターン、自然な文章への修正、誤検出、検出ツールの使用	references/ai-isms-and-humanisation.md
文脈に応じた回避ルール、表現パターン、自然な言い換え、保護対象の用法	references/formulaic-language-catalogue.md
ドキュメント、PR、仕様書、メモ、レポート、エッセイ、メール、UI、コピー	references/genre-modes.md
技術ドキュメントと Wiki の見出し、手順、リンク、アクセシビリティ、保守	references/technical-documentation-and-wikis.md
個人の文体シートとスタイル調整	references/style-bundles.md
合格基準と最終校正	references/quality-gates.md
調査の根拠と限界	references/research-notes.md
失敗からの復旧	references/gotchas.md

テンプレート

• templates/rewrite-worksheet.md は、複雑な作業でブリーフ、保持項目の記録、各パスの結果、最終チェックを記録する場合に使用できます。
• templates/personal-style-sheet.md は、改訂によって元の文体がならされてしまう前に、サンプルから書き手本人の実際の癖を把握するために使用します。

必ず守ること

1. 事実を変えて文体を改善しないでください。
2. 根拠なしに不確実な内容を確実なものとして書かないでください。
3. 個人的な経験、引用、出典、証拠、顧客の言葉を捏造しないでください。
4. 特定の書き手の特徴的な文体を模倣しないでください。依頼をより一般的な特性に置き換えてください。
5. 表現リストや検出スコアを、著者を特定する証拠として使わないでください。
6. 文章を統計的に「人間らしく」見せるために、方言、アクセシビリティ、第二言語話者としての個性を削らないでください。
7. 類型的な表現に関するルールを、同義語に置き換えるだけで満たそうとしないでください。
8. 適用されるチェック基準を通過し、残る選択肢が好みの違いにとどまる場合は、編集を続けないでください。
9. コード、識別子、セレクター、設定キー、その他の機械可読な構造は変更しないでください。対象範囲内の自然言語の文章のみを修正してください。