生成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 テンプレート化によるAIのパターン認識の支援
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 柔軟性ゆえの課題と人間の役割
正誤表・ダウンロード
お問い合わせ
本書に関するお問い合わせは、下記のボタンをクリックしてお問い合わせフォームよりお問い合わせください。
author執筆者紹介
[ この書籍をシェアする ]
X(旧Twitter)
Facebook
LINE-
Copied!
関連する書籍
- 発売日
- 2024年9月19日
