Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Save YSRKEN/c10b25539c73007df4d0dbd887d84b14 to your computer and use it in GitHub Desktop.
Save YSRKEN/c10b25539c73007df4d0dbd887d84b14 to your computer and use it in GitHub Desktop.
# 自然な日本語文章を生成するためのライティングガイドライン
AIの機械的な文を避け、読み手にとって自然でわかりやすい日本語へ整えるための実践ガイドです。冗長さを抑えつつ、判断の根拠や置き換え例を増やし、すぐに使える形にまとめました。
## トーン(中立・提案・配慮)
- 中立: 「〜の可能性があります」「〜場合があります」など断定を避けて丁寧に。
- 提案: 「〜をご検討ください」「〜してみてください」など行動の選択肢を示す。
- 配慮: 「読み手によっては」「人によっては」など多様な読者を想定する。
- ポイント: 指摘は断罪せず、理由と代替案を添えて短く示す。
## 原則(5C + 構造)
- 簡潔: 冗長を削る。「することができます」→「できます」/「まず最初に」→「まず」。前置きが長い場合は結論を先に。
- 明確: 能動態と具体動詞。「処理が行われます」→「システムが処理します」。主語・対象・条件を明示。
- 具体: 抽象語を数値・事実に。「高速」→「応答50ms未満」、「大幅」→「従来比200%」。判断基準を一文で添える。
- 一貫: 用語・文体・UI名を統一。プロジェクトの正式名称や「です・ます調/だ・である調」を混在させない。
- 正確: 事実・用語を厳密に。推定は根拠を添える。「おそらく」は避け、条件を明示。
- 構造: 一文一義、段落は一テーマ。導入→要点→補足の順。見出しで階層、連続手順は番号付きリスト。
## スタイルの注意
- コロン継続の直訳調を避ける: 「実行します:」→「次のように実行します。」。
- 太字+コロンの見出し化を控える: 「- **注意**:」→「- 注意事項:」。
- 絵文字の多用は控える(✅❌🔥🚀など)。意味はテキストで表す。
- 名詞止めの連続は読みづらい。動詞で結ぶか、文を分割する。
- 50文字超の長文は分割を検討。接続詞は最小限に。
## 誇張・定型句の置き換え
- 革命的な/究極の/完璧な → 改善内容と根拠(数値・比較・制約)。
- 可能性を解き放つ/スーパーチャージ → 具体的効果(処理時間短縮、手順削減など)。
- 世界初の/最先端の → 出典・比較対象を明示。なければ控える。
- 業界を再定義/未来を変える/パラダイムシフト → 何が、誰に、どの指標で、どれだけ変わるかを書く。
## よくある書き換え(実用メモ)
- 「の変更を行う」→「を変更する」/「の実装を実施する」→「を実装する」。
- 「可能となります」→「できます」/「使用することが可能です」→「使用できます」。
- 「〜されます」→「〜します」/「〜されることになります」→「〜になります」。
- 「例えば。」→「たとえば、次のような点があります。」。
- 「このドキュメントにおいて」→「このドキュメントでは」。
- 「なお、」の連発は避け、補足は別段落か箇条書きに。
## リスト・見出し・導入のコツ
- 箇条書きの前に一文で目的を述べる(例:「主な理由は次の3点です。」)。
- 項目は並列関係を保ち、語尾や文体を揃える(体言止めなら統一)。
- 手順は番号付き、注意点は別小見出しでまとめると読みやすい。
## チェック手順(短いループ)
1. 目的→結論→根拠の順で下書き。
2. 本プリセットでLint(表現の機械感・誇張・構造を確認)。
3. 指摘を踏まえて修正。数値・主語・用語の統一を再確認。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment