Markdown ドキュメント作成スキル

概要

提案書・報告書・議事録などのビジネスドキュメントを Markdown で作成する。 再利用性・検索性・差分管理に優れた形式で、そのまま使える品質を目指す。

トリガーワード

• 「提案書」「報告書」「議事録」「ドキュメント作成」
• 「Word」「Markdown で書いて」「文書作成」
• 「アジェンダ」「要件定義書」「仕様書」

使用しない場合

• PPT / スライド作成（→ slide-creator）
• README やコード内コメント
• API ドキュメントの自動生成

---

作成ワークフロー

Step 1: 要件確認

確認項目	質問
目的	何のためのドキュメント？（提案、報告、教育、共有）
対象読者	誰が読む？（経営層、技術者、顧客、社内）
分量	目安は？
トーン	フォーマル？カジュアル？

Step 2: アウトライン提示

必ず内容作成の前にアウトラインを提示し、承認を得る。

Step 3: コンテンツ作成

承認後、セクションごとに内容を作成する。

---

ドキュメント種別テンプレート

提案書

1. エグゼクティブサマリー
2. 現状の課題
3. 提案するソリューション
4. 期待される効果（定量＋定性）
5. 実施スケジュール
6. 概算費用
7. 体制・サポート
8. 次のステップ

技術調査報告

1. 調査の目的
2. 調査範囲と手法
3. 調査結果（サマリー）
4. 詳細分析
5. 比較表（該当する場合）
6. 推奨事項
7. 参考文献

議事録

1. 会議情報（日時・参加者・目的）
2. アジェンダ
3. 議論内容
4. 決定事項
5. アクションアイテム（担当者・期限）

---

対象読者別の調整

対象	フォーカス	避けるべきこと
経営層	ビジネスインパクト、ROI、リスク	技術詳細、専門用語
技術者	アーキテクチャ、実装、選定理由	曖昧な表現、マーケ用語
顧客	課題解決、具体的なメリット	自社都合の話

---

図表の使い方

• Mermaid ダイアグラムを積極的に使う（フローチャート、シーケンス図、ガントチャート）
• 比較は Markdown テーブルで
• 数字は表やリストで視覚的に整理する

---

出力ルール

保存先

output/documents/YYYY-MM-DD_HHmmss_ドキュメント名/document.md

品質基準

• 日本語で作成する
• そのまま使える品質を目指す
• 具体的な数字・事実を優先する（「多くの」ではなく「80%の」）
• ドキュメントの最後に情報源一覧を入れる
• 既存ファイルは絶対に上書き・削除しない