- ホーム
- > 和書
- > コンピュータ
- > プログラミング
- > ＳＥ自己啓発・読み物
出版社内容情報
生成AIの急速な普及により、ドキュメントは単なる「人間のための説明書」から、「AIのための知識源」へとその役割を拡張させています。
ChatGPTやGeminiのような対話型AIが正確な回答を生成するためにも、またClaude CodeのようなAIエージェントが自律的にタスクを遂行するためにも、AIが情報を正しく探索・理解できるドキュメントの存在が不可欠です。
本書は『エンジニアが一生困らない ドキュメント作成の基本』の著者、仲田尚央氏による、AIが探せる／読める／理解できるためのドキュメント作成＆運用方法が１冊にまとまった、新時代のエンジニア必携の一冊です。
?一度でAIと人間どちらにも読みやすいドキュメントを書く方法とは？
?人間向けに書かれたドキュメント、AI向けにどう最適化する？
――普遍的な原則と実践テクニックのすべてを詰め込みました！
【目次】
Chapter1 AI時代により重要になるドキュメント
1-1 なぜAIリーダビリティが重要か
1-2 AIリーダビリティが高めるAIのパフォーマンス
1-3 ドキュメントの種類と本書のスコープ
Chapter2 ドキュメントをAIが参照する仕組み
2-1 ドキュメントがAIの知識として機能する仕組み
2-2 検索と読み込みのメカニズム
2-3 AIが参照しやすいドキュメントの特徴
Chapter3 AIリーダビリティを意識したドキュメントの配置
3-1 ファイル形式とツール
3-2 情報源の集約とアクセス性
3-3 コードとドキュメントの同居
3-4 ディレクトリー階層とファイルの配置
Chapter4 AIの検索と推論を支える情報の構造化
4-1 ドキュメントの構造化がなぜ必要か
4-2 AIからの参照を意識した構造化戦略
4-3 マークアップと分割による構造の実装
4-4 メタデータとリンクによる情報の結合
4-5 構造の規格化（パターン構造）
Chapter5 AIに正しく伝わる文章の書き方
5-1 文章を構成する情報の階層
5-2 見出しの組み立て
5-3 パラグラフの組み立て
5-4 文の組み立て
5-5 コードブロックとコンテキスト
5-6 用語の統一と定義
Chapter6 ドキュメントの品質を担保する運用
6-1 信頼できる唯一の情報源（SSOT）の維持
6-2 品質担保のためのレビューとフィードバック
Chapter7 AIを活用したドキュメント作成
7-1 ドキュメント作成における人間とAIの役割分担
7-2 AIへの丸投げを防ぐアウトラインの構築
7-3 意図を正確に伝えるプロンプトのテクニック
7-4 AI特有の論理の誤りとその修正
Chapter8 AIエージェント時代のオープンフォーマットとドキュメント設計の未来
8-1 OKFの概要と設計思想
8-2 OKFフォーマットの具体的な構造
8-3 OKF運用における本書の活用
8-4 柔軟性ゆえの課題と人間の役割
内容説明
ドキュメントを制するエンジニアはＡＩを制す！！ＡＩリーダブルなドキュメントとは？一度でＡＩと人間に正しく伝えるコツとは？人間向けドキュメントをＡＩ向けに最適化するには？作成から運用までＡＩが探せる・読める・理解できるための全テクニック。
目次
１ ＡＩ時代により重要になるドキュメント
２ ドキュメントをＡＩが参照する仕組み
３ ＡＩリーダビリティを意識したドキュメントの配置
４ ＡＩの検索と推論を支える情報の構造化
５ ＡＩに正しく伝わる文章の書き方
６ ドキュメントの品質を担保する運用
７ ＡＩを活用したドキュメント作成
８ ＡＩエージェント時代のオープンフォーマットとドキュメント設計の未来
著者等紹介
仲田尚央［ナカタナオヒロ］
テクニカルライター、ＵＸライター。主にソフトウェアのＵＩテキストやドキュメント（マニュアル、リリースノートやテクニカルドキュメントなど）を書くことを専門とする。また、それらのローカライズにも携わる。サイボウズでテクニカルライター、ローカライズ部門のマネージャーを務めたのち、２０２４年から現職であるＳｍａｒｔＨＲで活動中。本業の傍らで、企業や学生向けにテクニカルライティングのセミナーを実施。Ｄｅｖｅｌｏｐｅｒｓ Ｓｕｍｍｉｔ ２０２３アワード受賞。都立産業技術高等専門学校非常勤講師（本データはこの書籍が刊行された当時に掲載されていたものです）
※書籍に掲載されている著者及び編者、訳者、監修者、イラストレーターなどの紹介情報です。
