生成AIの進化によって、誰でも文章や説明資料を簡単に作れる時代になりました。 しかし、設計書やプレゼン資料など、読み手に何かを伝えるアウトプットでは、構成や文脈への配慮が欠かせません。
私自身、エンジニアとして日々、文字によるアウトプットを行う中で、「伝わる文章」を意識しています。このブログでは、日本語的な文法の話というよりかは、ドキュメントとしての文章設計のポイントを実体験を交えて考察していきます。
また、各セクションでは「こうすると伝わりづらくなる」というアンチパターンも紹介しています。実際の現場でありがちな落とし穴にも触れながら、伝わる文章の設計ポイントを考えていきたいと思います。
生成AIの時代に求められる力
生成AIの進化により、コーディングや資料作成など、さまざまな作業が短時間で行えるようになりました。つまり、アウトプットのコストが大きく下がったということです。
アウトプットが容易になると、次に求められるのはその内容の良し悪しを判断する力です。たとえば、生成AIで作成されたコードをそのまま納品することはありません。バグの有無、保守性、拡張性などを人間がチェックする必要があります。そのためには、一定の技術的知識が不可欠でして、それは文章作成も同様です。
生成AIを使って構成の作成や推敲を行うことは一般的になりましたが、最終的にその文章が「伝わるかどうか」を判断するのは人間です。論理展開に無理がないか、読み手に配慮されているかなど、細かなチェックは人間による判断がまだ必要だと思います。
だからこそ、これからの時代に求められるのは、アウトプットを評価・改善できる力だと私は考えています。 このブログでは、その一環として「文章の良し悪しを見極める視点」について、私自身の経験をもとに考察していきます。
分かりやすい文章とは何か?
先ず初めに分かりやすい文章とは、読み進める中で？が生じない文章と定義します。
読み手が「これってどういう意味？」「何が言いたいんだろう？」と立ち止まる瞬間があると、思考が中断され、場合によっては読み戻しが必要になります。こうした“ポーズ”は、読み手にとって負荷が高く、最悪の場合は離脱につながります。
逆に、分かりやすい文章は以下のような特徴を持ちます。
- 読んでいて自然に頭に入ってくる
- 読み返さなくても理解できる
- 読み終えた後に疑問が残らない
このような文章を作るにはどうすれば良いかを一緒に考えていきましょう。
分かりやすい文章作成の具体的なアプローチ
さて、分かりやすい文章が具体的にどんな物かイメージが湧いてきたかと思いますので、ここからは具体的な３つのアプローチをご紹介します。
1. ペルソナ設定
文章を書く際にまず考えるべきは、「誰に向けて書くのか」「何のために書くのか」という点です。これを明確にするために、対象読者（ペルソナ設定）を設定することが非常に重要です。
手順書やブログなど、どんなドキュメントでも、ペルソナを定めることで、文章の粒度や言葉選びが適切になります。ペルソナが曖昧なままだと、主観的で自分本位な表現になり、読み手に伝わりづらくなってしまいます。
例えば、生成AIの仕組みを初学者向けに説明する場合、以下のような文章ではどうでしょうか？
生成AIは、トランスフォーマーなどの深層学習モデルが、大規模なデータセットから複雑な確率分布を学習します。
これにより、入力されたプロンプトに基づき、学習した潜在空間からサンプリングすることで、高品質なテキストや画像を生成する技術です。
専門用語の説明がなく、初学者には理解が難しい内容です。では、次のような表現ならどうでしょうか？
生成AIは、インターネット上の膨大な情報からパターンを学習し、まるで人間が作ったかのように新しい文章や画像を自動で生み出す技術です。
例えば、たくさんの絵を見て描き方を学んだ画家が、新しい絵を描くようなものです。
初学者の人でもこの内容であれば分かりやすいと思います。絵描きの例もあったりでイメージが湧きやすいのではないでしょうか。このように設定するペルソナ次第で文章の書くべき粒度が変わってくるのです。
ペルソナ設定をする上では特に以下の３点が重要です。
- 知識レベルを想定する
- 読み終えた後、どういう状態になって欲しいのかをイメージする
- ポーズポイントを意識して読み返す
1については、今お伝えした生成AIの例です。
2については、ペルソナがそのアウトプットを読み終えた時にどういう状態になって欲しいか？ゴールを設定します。ゴールを明確にして、そこから逆算して中身の構成を作成することで、ブレのない文章になります。（概念レベルで理解してほしいのか、具体的な使い方まで知ってほしいのか等）
その上で、3.ポーズポイントを意識して読み返します。 ポーズポイントは、読者が「ん？」「どういう意味だろう？」と感じて思考が止まる箇所です。これはペルソナによって異なるため、相手の靴を履くような視点で読み返すことが求められます。
ここでのアンチパターンはペルソナ設定をせずに、自分向けの読み物を作ってしまうことです。ペルソナ設定と、ペルソナの視点で読み返すことが重要です。
2. 構造化
文章が読みやすいかどうかは、構造化されているかに大きく左右されます。構造化された文章とは、地図のように全体を俯瞰させ、読者を目的地へ誘導する文章です。
構造がない文章は、情報が断片的で、説明があちこちに散らばってしまいがちです。そうなると、読者は「何の話をしているのか」「どこに向かっているのか」が分からず、読み進めるのに余計な負荷がかかってしまいます。
一方で、構造化された文章は、地図のように全体を俯瞰でき、読み手を目的地へとスムーズに導いてくれます。
構造化された文章を作るために、私は以下の3つのポイントを意識しています。
1.メンタルモデルの構築
冒頭で「これから〇〇について話します」と宣言することで、読者は内容を予測しやすくなり、理解の助けになります。
私のブログを例にとると、ブログの冒頭に必ずこれから何について話そうとしているのか、という宣言をするようにしています。そうすることで、読者はこれからどういった話が展開されるのか心の準備ができます。
ブログを書く際は冒頭にメンタルモデルを構築するようにしている
※添付画像のブログは終盤にリンクを記載しています。
2.親子関係の意識
パラグラフ内やパラグラフ間で、抽象→具体の流れがあるか、並列関係が整理されているかを確認します。
親子関係の例
3.ストーリー構成のチェック
全体を通してストーリー性があるか、論理展開に無理がないかを読み返して確認します。 ストーリー性を持たせる上で私が意識しているのは、Why → How → Whatの流れを持たせることです。
- Why（なぜ）：この文章を書く理由や背景
- How（どのように）：その理由に対して、どんな方法で説明するか
- What（何を）：具体的な内容やアクション
この流れは、ビジネスでもよく使われる「ゴールデンサークル」と呼ばれる考え方で、人は「なぜ」に動かされると言われています。文章でもこの順番を意識することで、読み手の理解と納得感が格段に高まります。
ストーリー構成の例
ここでのアンチパターンは、階層構造を無視した文章の寄せ集めを作ってしまうことです。各パラグラフ単体で見るのではなく、全体を通して読んだ時に違和感が無いか？というチェックが重要です。
文章の寄せ集めとは、言わば順番がバラバラな紙芝居を作るようなものです。各スライド単体の意味は分かるのですが、全体の流れで見た際に順番がグチャグチャなので、結果的に読者にとって非常にハイカロリーな読み物になってしまいます。
3. 宣言と定義
ここまでで、文章を書く際には「誰に向けて書くか（ペルソナ設定）」と「全体の構造をどう設計するか（構造化）」が重要であることをお伝えしました。 この章では、各パラグラフの中で意識すべき“宣言”と“定義”についてご紹介します。
宣言：読者との初期同期
宣言とは、パラグラフの冒頭で「これから何について話すのか」を明示することです。これは、先述したメンタルモデルの構築にもつながります。
宣言があることで、読者は「この段落では〇〇について説明されるんだな」と予測を立てながら読み進めることができ、理解の負荷が大きく下がります。これは、文章の流れをスムーズにするための初期同期のような役割を果たします。
定義：認識のズレを防ぐ
定義とは、文章中に登場する専門用語や新しい概念について、意味を明確に説明することです。定義がないと、読者は「この言葉ってどういう意味だろう？」と立ち止まり、思考が中断されてしまいます。
定義を添えることで、筆者と読者の間の認識のズレを防ぎ、理解を深めることができます。 このように、段落の冒頭で宣言し、続く文章で定義を丁寧に行うことで、読者は安心して読み進めることができます。
世の中的にそこまでメジャーじゃない単語についてはもちろんですが、日本語的にみんな知ってるよね？という単語でも場合によっては再定義することが良いケースもあります。
例えば、ブログの冒頭でも、分かりやすい文章という言葉について再定義をしたかと思います。 日本語的には、「分かりやすい文章」という言葉の意味は理解できると思います。ただし、ここで「分かりやすい文章＝読み進める上で？が起きない文章」と再定義をすることで、私が伝えたい意図や、ブログの趣旨がより鮮明になったと思います。
言葉の定義に筆者と読者間でズレが生じると、そこからボタンの掛け違いが起きて、全体を通して読者が誤解してしまうケースがあります。なので、この定義を筆者と読者間で揃えるという工程は非常に重要です。
定義には改めて整理すると３パターンに分類することができます。
- 専門的な単語
- 例）ハードスキルやソフトスキルなど専門的な言葉
- 読者によって解釈が異なる単語
- 例）Migrationのような同じエンジニアでもアプリケーションエンジニアとインフラエンジニアの間で解釈が異なる言葉
- 再定義をすることで、より深い理解が得られる単語
- 例）「分かりやすい文章＝読み進める中で？が生じない文章」のように日本語的には理解できるが、その言葉がどういう意味で使われているかを明示することで、読者との認識を揃えることができる言葉
ここでのアンチパターンは、新出単語についての解説がない、冒頭に何について説明をするのか宣言がない文章を作ってしまうことです。
タイトル設定にも注意を払いつつ、新出単語は基本的に説明を入れて、各パラグラフでもメンタルモデルの構築を意識するようにしましょう。
おわりに
私が個人的に意識していることは、作成した文章を何度も見返すことです。 これは長い時間をかけて推敲するということではなく、書いた文章を読み返す回数を増やすということです。
自分の中では「良い文章が書けた！」と思って翌朝チェックしてみると、「あれ？なんか違う」なんてことも私の場合はわりと良くあります。
各パラグラフの内容が良くても、各パラグラフ間の繋がりが悪いと、結果的に読みにくいアウトプットになってしまいます。それは非常にもったいないことですので、全体構成を見直すという意味でも、文章を寝かせるという作業が結構大事なのかなと思っています。一人でも多くの方に参考になると嬉しいです。
※添付画像のブログ
SIer勤めの僕が考えたエンジニア生存戦略 - NRIネットコムBlog
構成図を描く際に気をつけていること - NRIネットコムBlog
エラー解決で多用する思考法２選 - NRIネットコムBlog
なぜ令和のエンジニアに呆活が必要なのか - NRIネットコムBlog
