生成AI時代の文章術・テクニカルライティング書籍ガイド｜AIに読ませる文書と、AIが書いた日本語を直す4冊

生成AIを業務に入れると、意外なところで詰まります。社内Wikiを丸ごとRAGに載せたのに、検索が的外れな断片を拾ってくる。エージェントに仕様書を渡したのに、前提を取り違えた実装を出してくる。AIに議事録を書かせたが、そのままでは配れないので結局30分かけて直している。これらはモデルの性能というより、渡している文書の書き方と、直す側の判断軸の問題であることが少なくありません。この記事では、生成AI時代に効き目が上がった技能として「文章術・テクニカルライティング」を取り上げ、実在の書籍を4冊、段階順に紹介します。なお本記事は書籍紹介であり広告を含みます。価格・版・在庫・内容は変わるため、最新は各出版社の公式書誌ページでご確認ください。

なぜ、いま文章術の効き目が上がったのか#

「文章がうまいに越したことはない」という話ではありません。生成AIを業務システムに組み込むと、文章の書き方が測定可能な形で結果に効いてくる場面が2つ生まれます。

1つは、AIに読ませる側です。RAGでもAIエージェントでも、モデルが参照するのは自社が書いたドキュメントです。人間なら文脈で補って読めるあいまいさを、検索と生成のパイプラインはそのまま引き受けます。もう1つは、AIが書いた日本語を人間が直す側です。生成された文章は体裁が整っているぶん、どこが問題なのかを言語化しにくく、「なんとなく読みにくい」で止まると直せません。直す側に判断軸がないと、指示を出し直すこともできません。

この2つは、実は同じ技能に支えられています。読み手を定義し、一文の中身を絞り、用語を統一し、構造で示す。テクニカルライティングと呼ばれてきた領域そのものです。

ドキュメント側の構造が、検索と生成に効く理由#

RAGは文書を丸ごとモデルに渡すわけではなく、分割してから検索します。この分割の手がかりとして、文書の構造が使われます。Microsoft LearnのAzure AI Searchのチャンク分割に関するドキュメントでは、文末の句読点や改行、あるいは文書構造を検出する自然言語処理の機能に基づいて分割する方法が挙げられ、HTMLやMarkdownのような埋め込みマークアップは見出し構文をセクション単位の分割に使えると説明されています。同じページでは、大きな文書を扱うときに、途中のチャンクへ文書タイトルを付け足して文脈の欠落を防ぐという組み合わせ方も紹介されています。

つまり、見出しがない文書、見出しがあっても内容を表していない文書は、分割の手がかりを自ら捨てていることになります。逆に、見出しが内容を素直に表していて、階層が飛んでいない文書は、それだけで検索の単位が整います。

用語の揺れも同様です。Googleの開発者向けドキュメントスタイルガイドは、翻訳と国際的な読者を意識した章で、ある概念にある用語を使ったなら、大文字小文字の表記も含めて他の場所でもまったく同じ用語を使うよう求めています。同じ概念に別の言葉を当てると、別の概念だと受け取られるからです。この理屈は、単語の分散表現で検索する仕組みにもそのまま当てはまります。「顧客ID」「ユーザーID」「アカウント番号」が同じものを指しているという知識は、文書の外にしか存在しません。

同じスタイルガイドは、代名詞があいまいなら適切な名詞に置き換えること、能動態を使って誰が何をするのかを明確にすること、名詞を3つ以上つなげて修飾語にしないことも挙げています。見出しについては別ページで、記述的な見出しを使うこと、見出し階層のレベルを飛ばさないこと、中身のない空の見出しを使わないことが示されています。いずれも人間の読みやすさのための指針ですが、機械が構造を頼りに文書を切り分ける時代には、そのまま検索品質の話になります。

書き方の癖と、パイプラインで起きること#

RAGやエージェントに文書を渡す前提で、よくある書き方の癖を整理すると次のようになります。

最後の「参照先が失われる」問題には技術側の対処もあります。Anthropicが公開しているContextual Retrievalは、各チャンクに文書全体から見た短い文脈説明を付けてからインデックスするという手法で、断片が単独では意味を失う問題への対応として紹介されています。ただし、これは前処理側の工夫であって、元の文書に書かれていない前提までは補えません。文書側で書けることは文書側で書いておくほうが、確実で安上がりです。

AIが書いた日本語を、どこで直すか#

もう1つの切り口です。生成された日本語には、モデルや設定を問わず、編集作業で繰り返し当たる傾向があります。以下は編集部で原稿を直すときに使っている観点で、特定モデルの優劣を述べるものではありません。モデルもプロンプトも変われば出力の癖は変わるため、あくまで「まずここを見る」という順序として読んでください。

このうち、係り受けと修飾の順序は日本語固有の話で、英語圏のスタイルガイドではカバーされません。主語の明示や一文一義は英語圏のガイドにもありますが、日本語では主語を省いても文が成立してしまうぶん、意識的に扱う必要があります。だから日本語の構造を扱った本が、いまだに現役で効きます。

選書の段階を4つに分ける#

文章術の本は棚では隣り合っていますが、扱う層はかなり違います。次の4段階のどこで詰まっているかを先に決めると、通読の目的がぶれません。

4冊すべてを読む必要はありません。書いた文書が長いのに伝わらないなら1、一文が読みにくいと言われるなら2、文書の型が毎回ばらつくなら3、社内Wikiが放置されて古びているなら4、というように、いま近い場所の1冊を読み切るほうが身につきます。

1. 何を書き、何を捨てるかを決める(理科系の作文技術)#

最初の1冊は、1981年9月22日に初版が刊行された中公新書のロングセラーです。著者は物理学者の木下是雄で、中央公論新社の書誌データでは新書判256ページ、定価924円(10%税込)、ISBN 978-4-12-100624-0となっています。

出版社の紹介文によれば、理科系の研究者・技術者・学生に向けて、論文・レポート・説明書・仕事の手紙の書き方や学会講演のコツを具体的に示す内容で、「盛りこむべき内容をどう取捨し、それをどう組み立てるかが勝負だ」という主張が軸に置かれています。文のうまさに主眼を置いた従来の文章読本とは一線を画し、ひたすら明快・簡潔な表現を追求した本として説明されており、文科系の読者からも支持を得てきたと紹介されています。

生成AIの文脈でこの本を最初に置く理由は、AIが最も肩代わりしにくいのが「何を書き、何を捨てるか」の判断だからです。文章を整える作業や、決まった型に流し込む作業は、生成AIに任せられる部分が増えました。一方で、この仕様書に何を書くべきか、この報告に何を含めるべきかは、業務の文脈を持つ人間にしか決められません。AIが出してきた網羅的な出力から、要らない段落を削る判断も同じです。この本は、その判断のための原則を扱っています。

扱っていない範囲も明確です。1981年の刊行なので、当然ながら生成AIもオンラインドキュメントも対象外です。日本語の助詞や修飾の順序といった文法寄りの技術も主題ではありません。また、扱う文書は論文・レポート・説明書が中心で、プロダクトのドキュメント運用やチーム体制の話は含まれません。単体で完結する本ではなく、以降の3冊の土台として読むのが現実的です。

理科系の作文技術(中央公論新社・中公新書)

広告

著者: 木下是雄 / 出版社: 中央公論新社(中公新書) / 1981年9月22日初版 / 新書判256ページ / 定価924円(10%税込)。論文・レポート・説明書・仕事の手紙の書き方と、学会講演のコツを扱います。内容の取捨と組み立てを判断の軸に置きたい人に向いています。生成AI関連の話題、日本語文法の細部、ドキュメント運用は対象外です。

Amazonで見る楽天で見るYahoo!ショッピングで見る

※価格・在庫は変動します。最新の情報は各販売サイトでご確認ください。

2. 日本語の構造を扱う(新版 日本語の作文技術)#

2冊目は、日本語そのものの構造に踏み込んだ一冊です。朝日新聞出版の朝日文庫から2015年12月7日に新版が発売されており、A6判並製328ページ、定価858円(税込)、ISBN 9784022618450です。著者は本多勝一で、出版社は「目的はただひとつ、読む側にとってわかりやすい文章をかくこと、これだけである」という一節を紹介文に掲げています。新版は、長く読み継がれてきた文章術の書籍を、文字を大きく読みやすくしたものと説明されています。

目次は9章構成です。第一章「なぜ作文の『技術』か」、第二章「修飾する側とされる側」、第三章「修飾の順序」、第四章「句読点のうちかた」、第五章「漢字とカナの心理」、第六章「助詞の使い方」、第七章「段落」、第八章「無神経な文章」、第九章「リズムと文体」と進みます。第四章は句点と記号、読点の統辞論、テンの二大原則の検証に分かれ、第六章は係助詞の「ハ」、マデとマデニ、接続助詞の「ガ」、並列の助詞といった項目で構成されています。

AIが書いた日本語を直す作業に、この本の第二章から第四章が直接効きます。生成された文に感じる読みにくさの多くは、修飾語が長い順に並んでいない、読点が構文と無関係な位置に打たれている、修飾先が2通りに読めるといった構造の問題です。この本を読んでおくと、「なんとなく読みにくい」を「この修飾句は長さの順序が逆」「このテンは係り受けを切っていない」という直せる指摘に変換できます。指摘が具体的になれば、AIへの再指示も具体的にできます。

限界も書いておきます。この本は日本語の文の構造を扱う本であり、技術文書の型やドキュメント運用は対象外です。刊行の性格上、生成AIへの言及もありません。また、第八章「無神経な文章」や第九章「リズムと文体」は著者の文章観が色濃く出る部分で、業務文書のルールとしてそのまま採用するかは判断が要ります。続編として、同じく朝日文庫から2019年4月5日に新版が出た『実戦・日本語の作文技術』(A6判並製336ページ、定価682円税込、ISBN 9784022619648)があり、実例分析を通じた応用編として紹介されています。

新版 日本語の作文技術(朝日新聞出版・朝日文庫)

広告

著者: 本多勝一 / 出版社: 朝日新聞出版(朝日文庫) / 2015年12月7日発売 / A6判並製328ページ / 定価858円(税込)。修飾の順序、句読点の打ち方、漢字とカナ、助詞の使い方、段落までを9章で扱います。AIが書いた文の読みにくさを構造の言葉で指摘したい人に向いています。技術文書の型やドキュメント運用、生成AIの話題は対象外です。

Amazonで見る楽天で見るYahoo!ショッピングで見る

※価格・在庫は変動します。最新の情報は各販売サイトでご確認ください。

3. 技術文書の型を覚える(技術者のためのテクニカルライティング入門講座 第2版)#

3冊目は、技術者向けの実務文書に絞った国内書です。翔泳社から2024年12月18日に第2版が発売されており、A5判252ページ、定価2,640円(本体2,400円+税10%)、ISBN 9784798188423です。著者は髙橋慈子です。

目次は9章構成で、第1章がロジカルライティングとテクニカルライティングの基礎知識、第2章がわかりやすく簡潔な文章を書くテクニック、第3章が読み手に伝わる文章を書くテクニック、第4章が読みやすさを高める文書フォーマット(表現・表記のルール)、第5章から第8章が実践編としてユーザーマニュアル・取扱説明書、提案書、障害報告書、社外メール文、そして第9章が生成AIの技術文書への活用です。各章末には演習や実践トレーニングが置かれています。

節レベルの構成が具体的で、第2章には「一文一義で書く」「文を長くしない」「一文を短く。50字以内で収めるように」「5W2Hを盛り込み、曖昧な文章にしない」といった項目が並び、第3章には「最も重要な内容を先に書く」「形容詞や名詞でなく、動詞でズバリと書く」「否定表現に気を付ける」「受動態と能動態を使い分ける」「『など』を多用しない」といった項目が続きます。第4章では、要素の配置と書式、ブロック化、カッコの使い分け、階層構造を数字や記号で示す方法、箇条書き、カタカナ語と英字表記のルールが扱われます。

紹介した4冊のうち、AIに読ませる文書の書き方に最も直結するのがこの本です。一文一義、5W2Hの明示、能動態と受動態の使い分け、階層構造の示し方、カタカナ語と英字表記の統一。これらはそのまま、前半で挙げた「文書側の癖」への対処になります。加えて第2版では生成AIの章が追加されており、出版社の内容紹介によれば、生成AIを使った効率的な文章の書き方・校正・要約の仕方に加え、生成AIを利用する際の注意点も扱っています。機密事項を扱う技術者向けの注意という位置づけで説明されている点も、社内展開を考える立場では確認しておく価値があります。

扱っていない範囲としては、日本語の係り受けや修飾の順序といった文法の細部は主題ではありません。また、扱う文書はマニュアル・提案書・障害報告書・メールが中心で、開発者向けAPIリファレンスやチュートリアルといったプロダクトドキュメントの体系、公開後の運用や品質測定は次の4冊目の領域です。

技術者のためのテクニカルライティング入門講座 第2版(翔泳社)

広告

著者: 髙橋慈子 / 出版社: 翔泳社 / 2024年12月18日発売 / A5判252ページ / 定価2,640円(本体2,400円+税10%)。一文一義や5W2Hといった文章のテクニックから、文書フォーマット、マニュアル・提案書・障害報告書・社外メールの実践編、生成AIの技術文書への活用までを9章で扱います。章末に演習があり、社内研修の教材にも使いやすい構成です。日本語文法の細部やプロダクトドキュメントの運用は主題ではありません。

Amazonで見る楽天で見るYahoo!ショッピングで見る

※価格・在庫は変動します。最新の情報は各販売サイトでご確認ください。

4. ドキュメントを製品として運用する(エンジニアのためのドキュメントライティング)#

4冊目は、ドキュメントを書いて終わりにせず、運用の対象として捉える一冊です。原著は2021年9月30日にApressから刊行された『Docs for Developers: An Engineer's Field Guide to Technical Writing』で、邦訳は日本能率協会マネジメントセンターから2023年3月11日に『ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング』として刊行されました。A5判248ページ、定価は本体2,600円+税、ISBN 9784800590831です。著者はジャレッド・バーティ、ザッカリー・サラ・コーライセン、ジェン・ランボーン、デービッド・ヌーニェス、ハイディ・ウォーターハウスの5名、訳者は岩瀬義昌です。

構成は3部11章です。PART Iがドキュメント作成の準備で、第1章「読み手の理解」、第2章「ドキュメントの計画」。PART IIがドキュメントの作成で、第3章「ドキュメントのドラフト」、第4章「ドキュメントの編集」、第5章「サンプルコードの組み込み」、第6章「ビジュアルコンテンツの追加」。PART IIIがドキュメントの公開と運用で、第7章「ドキュメントの公開」、第8章「フィードバックの収集と組み込み」、第9章「ドキュメントの品質測定」、第10章「ドキュメントの構成」、第11章「ドキュメントの保守と非推奨化」となっています。

RAGやAIエージェントに社内文書を食わせる取り組みで、最終的に効いてくるのがこの層です。文章術の本を読んで個々の文書がうまく書けるようになっても、古い記述が残り続ければ検索は古い答えを返します。第9章の品質測定、第11章の保守と非推奨化は、まさにその問題を扱います。第1章の読み手の理解と第2章の計画も、AI向けの文書整備と相性がよい部分です。誰が読むのかを定義しないまま書かれた文書は、人間にとってもAIにとっても使いにくいままです。

限界も明示しておきます。本書はプロダクトのドキュメント、つまり外部の開発者やユーザーに向けたドキュメントを主な対象にしています。社内の議事録や稟議書、業務手順書といった社内文書に、そのまま当てはまらない部分はあります。また日本語固有の文章技術は扱われません。邦訳は2023年3月ですが原著は2021年の刊行であるため、RAGやAIエージェントを前提としたドキュメント設計についても、本書の主題ではありません。この本から得るのは運用の枠組みで、AI向けの具体策は自分たちで足す前提になります。

エンジニアのためのドキュメントライティング(日本能率協会マネジメントセンター)

広告

著者: ジャレッド・バーティほか5名 / 訳: 岩瀬義昌 / 出版社: 日本能率協会マネジメントセンター / 2023年3月11日発行(原著は2021年9月刊) / A5判248ページ / 定価本体2,600円+税。読み手の理解と計画から、ドラフト・編集・サンプルコード・ビジュアル、公開後のフィードバック収集・品質測定・構成・保守と非推奨化までを11章で扱います。ドキュメントを継続運用する仕組みを作りたい人に向いています。日本語固有の文章技術と、RAG前提のドキュメント設計は対象外です。

Amazonで見る楽天で見るYahoo!ショッピングで見る

※価格・在庫は変動します。最新の情報は各販売サイトでご確認ください。

4冊の使い分け#

いま詰まっている場所から選ぶための対応表です。刊行時期は、生成AIに関する話題をどこまで含むかの目安になります。翻訳書の場合、内容が書かれた時期を表すのは原著の刊行年のほうです。

生成AIそのものへの言及がある章を持つのは、この4冊のうち『技術者のためのテクニカルライティング入門講座 第2版』の第9章だけです。他の3冊は生成AI以前の本ですが、だからこそ判断軸として長く使えます。AIの機能は変わっても、読み手が誰で、何を伝えるのかという設計は変わらないからです。

書籍だけでは埋まらない部分#

正直に書いておくと、この4冊を読んでもRAGの精度は自動的には上がりません。書籍が与えてくれるのは判断軸と語彙で、実際の運用には少なくとも3つの追加作業が必要です。

1つは自社の用語集とスタイルガイドです。「顧客」と「ユーザー」と「取引先」をどう使い分けるのか、製品名の正式表記は何か、社内の略語をどこまで許すのか。これは書籍には書かれていません。参考にできる公開資料としては、Googleの開発者向けドキュメントスタイルガイドやMicrosoft Writing Style Guideが公開されていますが、いずれも英語圏向けです。日本語の自社ルールは、既存文書から頻出の表記ゆれを拾って作るのが現実的です。

2つめは、AIに渡すコンテキストの整備です。用語集そのものをシステムプロンプトや検索対象に含める、文書の冒頭に対象範囲と更新日を機械可読な形で書く、廃止された文書にはその旨を明示する。これは文章術ではなく情報設計の作業で、書籍の外側にあります。

3つめはレビュー運用です。文章術を学んだ人が1人いても、チームの文書は変わりません。レビュー観点をチェックリストにして、指摘を再現可能な言葉にし、繰り返し出る指摘はスタイルガイド側に昇格させる。この循環が回らないと、書籍の知識は個人の中に留まります。

本記事に記載した書名・著者・訳者・出版社・発売日・ページ数・判型・ISBN・定価・目次は、各出版社の公式書誌ページ(frontmatterのsources)で確認できた範囲の情報です。版・価格・在庫・目次は改定されることがあるため、購入前に各公式ページで最新情報をご確認ください。『理科系の作文技術』のページ数は中央公論新社の書誌データの表記に基づきます(刊行年が古く、他のデータベースでは異なるページ数が表示される場合があります)。各書籍の「扱っていない範囲」は、公開されている目次と出版社の内容紹介から判断できる範囲の整理であり、本文全体を網羅的に検証したものではありません。見出し構文によるセクション単位の分割、および文書タイトルをチャンクに付与して文脈の欠落を防ぐという記述は、Microsoft LearnのAzure AI Searchのチャンク分割に関するドキュメントに基づきます。用語の一貫性、あいまいな代名詞の置き換え、能動態、記述的な見出し、見出し階層を飛ばさないことに関する記述は、Googleの開発者向けドキュメントスタイルガイドの該当ページに基づきます。チャンクへの文脈付与の手法はAnthropicが公開したContextual Retrievalの紹介記事に基づきます。「AIが書いた日本語によくある癖」の表は編集部の作業実感を整理したもので、特定のモデルやサービスの性能を評価するものではありません。

明日から回すための最初の一歩#

読了後にドキュメント全体を書き直そうとすると手が止まります。効き目が出やすい順に、狭い範囲から変えるのが現実的です。

この順序は、4冊が共通して示している考え方を運用に置き換えたものです。読み手を定義し、構造で示し、用語を固定し、運用で維持する。生成AIの有無に関係なく有効ですが、AIが読む前提になった環境では効き目がはっきり出ます。

よくある質問#

まとめ#

生成AIが文章を書けるようになって変わったのは、下書きを用意する速度であって、何を書くべきかを決める作業や、書かれたものが正しいかを判断する作業ではありません。むしろ、AIが自社のドキュメントを読んで答えるようになったぶん、ドキュメントの構造は業務システムの一部になりました。今回紹介した4冊のうち3冊は生成AI以前の本ですが、だからこそ長く効きます。まずは自分が詰まっている段階の1冊を選び、よく参照される文書10本の見出しを書き直すところから始めてみてください。効果は、検索結果とレビューの往復回数という形で見えてきます。