エンジニアのためのAIに伝わるドキュメントの基本 [単行本]

エンジニアのためのAIに伝わるドキュメントの基本 の 商品概要

• 要旨（「BOOK」データベースより）

  ドキュメントを制するエンジニアはＡＩを制す！！ＡＩリーダブルなドキュメントとは？一度でＡＩと人間に正しく伝えるコツとは？人間向けドキュメントをＡＩ向けに最適化するには？作成から運用までＡＩが探せる・読める・理解できるための全テクニック。

• 目次

  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 柔軟性ゆえの課題と人間の役割

• 出版社からのコメント

  人間向けのドキュメント、そのままAIに読ませていませんか？

• 内容紹介

  生成AIの急速な普及により、ドキュメントは単なる「人間のための説明書」から、「AIのための知識源」へとその役割を拡張させています。
  
  ChatGPTやGeminiのような対話型AIが正確な回答を生成するためにも、またClaude CodeのようなAIエージェントが自律的にタスクを遂行するためにも、AIが情報を正しく探索・理解できるドキュメントの存在が不可欠です。
  
  本書は『エンジニアが一生困らない ドキュメント作成の基本』の著者、仲田尚央氏による、AIが探せる／読める／理解できるためのドキュメント作成＆運用方法が１冊にまとまった、新時代のエンジニア必携の一冊です。
  
  ▶一度でAIと人間どちらにも読みやすいドキュメントを書く方法とは？
  ▶人間向けに書かれたドキュメント、AI向けにどう最適化する？
  ――普遍的な原則と実践テクニックのすべてを詰め込みました！

• 著者紹介（「BOOK著者紹介情報」より）（本データはこの書籍が刊行された当時に掲載されていたものです）

  仲田 尚央(ナカタ ナオヒロ)
  テクニカルライター、ＵＸライター。主にソフトウェアのＵＩテキストやドキュメント（マニュアル、リリースノートやテクニカルドキュメントなど）を書くことを専門とする。また、それらのローカライズにも携わる。サイボウズでテクニカルライター、ローカライズ部門のマネージャーを務めたのち、２０２４年から現職であるＳｍａｒｔＨＲで活動中。本業の傍らで、企業や学生向けにテクニカルライティングのセミナーを実施。Ｄｅｖｅｌｏｐｅｒｓ　Ｓｕｍｍｉｔ　２０２３アワード受賞。都立産業技術高等専門学校非常勤講師

エンジニアのためのAIに伝わるドキュメントの基本 の商品スペック