doclisted

# doc ドキュメントを対話形式でヒアリングして生成する。 対話部分は親 Claude が担当し、生成は doc-writer エージェントが行う。 --- ## Step 1: ドキュメント種類の選択 AskUserQuestion ツール: ```json { "questions": [{ "question": "作成するドキュメントの種類を選択してください", "options": [ { "label": "mermaid図", "description": "フロー図・クラス図・ER図・シーケンス図など" }, { "label": "README", "description": "プロジェクト概要・セットアップ手順・使い方など" }, { "label": "操作手順書・運用手順書", "description": "画面操作・コマンド手順など" }, { "label": "API仕様書", "description": "エンドポイント・リクエスト/レスポンス定義など" } ] }] } ``` 「その他」が選ばれた場合（Other 入力）: 自由記述の内容をそのまま記録する。 --- ## Step 2: 対象ファイル・ディレクトリの指定 AskUserQuestion ツール: ```json { "questions": [{ "question": "ドキュメント化する対象ファイル・ディレクトリを教えてください（例: src/api/、models/user.py）" }] } ``` --- ## Step 3: 読み手の確認 AskUserQuestion ツール: ```json { "questions": [{ "question": "このドキュメントの読み手は誰ですか？", "options": [ { "label": "開発チームの新メンバー", "description": "コードを読み始める人" }, { "label": "開発チーム内", "description": "既存メンバーへの共有・引継ぎ" }, { "label": "運用・保守担当", "description": "エンジニアだがコードを書かない" }, { "label": "業務担当・非エンジニア", "description": "システムの利用者・管理者" } ] }] } ``` 「外部レビュアー・顧客・発注者」や「その他」が選ばれた場合（Other 入力）: 自由記述の内容をそのまま記録する。 --- ## Step 4: 目的の確認 AskUserQuestion ツール: ```json { "questions": [{ "question": "このドキュメントを作る目的を教えてください", "options": [ { "label": "全体把握・初見理解のため" }, { "label": "引継ぎ・担当交代のため" }, { "label": "レビュー・承認を得るため" }, { "label": "障害時の調査・対応のため" } ] }] } ``` 「新メンバーのオンボーディング」や「その他」が選ばれた場