Interview the user to flesh out handbook pages. Use when the user wants to update, expand, or create content in content/docs/ and says things like "アプデしたい", "書きたい", "質問して", "聞いて", or "中身を詰めたい".
ハンドブックの内容を充実させるためのインタビュー型コンサルテーション。ユーザーに質問を重ねて素材を集め、十分な情報が揃ったらドキュメントを書く。
対象ディレクトリの全ファイルを読み、関連する他セクションのファイルもgrepで探す。ユーザーに「何が書いてありますか?」と聞かない。
従業員目線で「これ読んでも具体的にどうすればいいかわからない」箇所を洗い出す。空ページ > 薄いページ > 補足が必要なページの優先順で。
1ラウンド3〜7問。以下のルールで構成する:
選択肢付き質問を基本にする:
1. **○○は何を指してる?**
- a) △△
- b) □□
- c) ◇◇
- d) 別の表現がある
自由記述は最小限に:
関連する質問をグルーピングする:
**A. ミッション・ビジョン**)回答を受けたら、次の質問に入る前に要約する。「さっきの回答をまとめると:」で箇条書きにし、解釈のズレを防ぐ。
以下の場合は追加ラウンドで深掘りする:
以下の場合はそのまま書きに進む:
ユーザーが「考えて」「提案して」と言った場合:
提案がズレていると言われたら:
十分な素材が揃ったら即座に書く。「書いていい?」と聞かない。