概要
https://note.com/michiomochi/n/nffa93191b5e9
詳細内容
## AIを活用したドキュメント執筆技術
https://note.com/michiomochi/n/nffa93191b5e9
音声入力とAI、人間による構成設計を組み合わせ、執筆の摩擦を最小化しながら高品質なドキュメントを作成する5ステップのワークフローを提案する。
**Content Type**: 📖 Tutorial & Guide
**Language**: ja
**Scores**: Signal:4/5 | Depth:3/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 83/100 | **Annex Potential**: 81/100 | **Overall**: 80/100
**Topics**: [[AIドキュメンテーション, 音声入力, Notion AI, textlint, 執筆ワークフロー]]
プロダクトマネージャーである著者が、PRDや社内方針ドキュメントの作成において実践している「AIと共作する執筆術」を具体的に解説している。著者は、AI時代のドキュメント作成において「人間が大枠（構成）を設計し、細かい肉付けをAIに任せる」という役割分担が、効率と品質を両立させる鍵であると主張する。
本記事で紹介されているワークフローは以下の5ステップで構成される。
1. **音声入力による思考の言語化**: キーボード入力で陥りがちな「完璧な文章を書こうとして筆が止まる」状態を避けるため、まずは音声入力で頭の中にあるアイデアを吐き出す。
2. **人間によるアウトライン作成**: AIに丸投げせず、人間が論理構成（H1〜H3の見出し）を設計する。これがドキュメントの品質を左右する設計図となる。
3. **AIによる叩き台の生成**: 音声入力の生データとアウトラインをAI（Notion AI等）に渡し、構造化された文章へと整形させる。
4. **AIによるlint-fixの実行**: AI特有の冗長な表現（「〜することができます」など）を排除するため、特定のルールに基づいた修正指示（lint-fix）をAI自身に実行させる。
5. **人間による手直し**: 最終的な事実確認、論理の一貫性、表現の洗練を人間が行う。
特に注目すべきは、ステップ4の「lint-fix」の概念である。著者は `textlint-rule-preset-ai-writing` のルールをプロンプトに組み込むことで、AIが生成した「AIっぽい不自然な文章」を自動的に人間らしい簡潔な表現へ変換する仕組みを構築している。
エンジニアにとって、技術仕様書やドキュメントの作成は避けられないが重いタスクである。著者が提案する「音声入力で摩擦を減らし、AIで構造化し、lintルールで表現を整える」という手法は、執筆の心理的ハードルを下げ、アウトプットの速度を劇的に向上させる実用的なアプローチである。最終的な責任は人間が持つという「AIアシスタント」の理想的な活用モデルが提示されている。