deep-interview について
的を絞った質問で知識を段階的に引き出し、回答を随時記録するアダプティブなインタビュースキルです。テーマ別ファイルや進捗管理、最終的な要約を通じて、整理されたナレッジベースの作成を支援します。
主な機能
- 01テーマに応じたアダプティブな質問
- 02各ラウンド後の回答記録
- 03テーマ別ファイルへの整理
- 04インタビューの進捗管理
- 05要約と未解決の質問の作成
活用シーン
- 01複雑なテーマに関する専門知識の記録
- 02複数ラウンドにわたる構造化インタビュー記録の作成
- 03調査結果の要約と知識ギャップの特定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ aviz85/ claude-skills-library --skill deep-interviewインストール後、Claude Code で/deep-interviewを入力して読み込まれたか確認します。
詳細
深掘りインタビュー
段階的に知識を引き出し、リアルタイムで整理されたナレッジベースを構築する、適応型インタビューを実施します。
基本の流れ
ASK -> LISTEN -> WRITE -> DEEPEN -> REPEAT
各サイクルでは、的を絞った質問をし、回答をファイルに記録して、不足している点を特定し、さらに深掘りします。回答するたびにナレッジベースが拡充されます。
プロセス
1. 初期化
ユーザーの入力からトピックを読み取ります。出力先を決定します。
--output <path>が指定されている場合:そのパスを使用します- CLAUDE.md があるプロジェクト内の場合:プロジェクトのルート、または関連するサブフォルダーを使用します
- デフォルト:
~/Documents/interviews/<topic>-<date>/を作成します
出力ディレクトリと _interview-index.md ファイルを作成します。
# Interview: <Topic>
**Date:** <today>
**Status:** In Progress
**Depth:** <shallow|medium|deep>
## Themes Discovered
(updated as interview progresses)
## Files Created
(updated as files are written)
2. オープニングラウンド — 全体像の把握
AskUserQuestion を使って全体像を把握します。1 回の呼び出しにつき、広範な質問を最大 2~3 個します。
最初の呼び出し — 範囲と、インタビュー対象者のトピックとの関係を明確にします。
- このトピックは何についてですか?(不明確な場合)
- ユーザーの役割や専門知識のレベルはどの程度ですか?
- この知識を記録する目的は何ですか?
重要: AskUserQuestion の回答を受け取るたびに、追加の質問をする前に、学んだ内容をすぐにファイルに書き込みます。回答を 1 ラウンド分を超えてため込んではいけません。
3. 適応型の深掘り
回答に基づいて、主要なテーマ(3~7 個)を特定します。各テーマについて:
<theme-slug>.mdファイルを作成します- AskUserQuestion を使って、そのテーマに関する的を絞った質問を 2~4 個します
- 回答をテーマのファイルに書き込みます
- テーマが十分に複雑な場合は、サブファイルに分割するためのサブフォルダー
<theme-slug>/を作成します
深さごとの質問戦略:
| 深さ | テーマごとの質問数 | ラウンド合計 | 出力ファイル数 |
|---|---|---|---|
| 浅め | 2-3 | 3-5 | 5-10 |
| 中程度 | 4-6 | 6-10 | 10-20 |
| 深め | 8-12 | 12-20 | 20-40 |
デフォルトの深さ:中程度。
4. 質問のテクニック
質問の種類を変えて、異なる層の知識を引き出します。
- **What(何)**の質問:事実、定義、構成要素
- **How(どのように)**の質問:プロセス、ワークフロー、手法
- **Why(なぜ)**の質問:理由付け、理念、判断
- **When/Where(いつ/どこで)**の質問:背景、きっかけ、条件
- **Who(誰)**の質問:関係者、対象者、役割
- **What if(もし~なら)**の質問:境界事例、例外、失敗
- 順位/優先度の質問:優先順位を決めてもらう質問(「上位 3 つを選んでください」)
- 比較の質問:「X と Y はどのように違いますか?」
ヒント: 可能な場合は AskUserQuestion の options フィールドで具体的な回答候補を提示してください。ユーザーが答えやすくなり、検証が必要な前提も明らかになります。
5. 書き込みルール
ファイル名: 説明的な kebab-case を使用します。例:target-audience.md、pricing-strategy.md、session-1-agenda.md
ファイル形式:
# <Theme Title>
> Source: Deep Interview, <date>
## Key Points
- Point extracted from answer
- Another point
## Details
<Expanded content from follow-up questions>
## Open Questions
- Things that still need clarification
フォルダー作成の条件: テーマに 3 つ以上のサブテーマがある場合は、フォルダーを作成します。
output/
├── _interview-index.md
├── overview.md
├── simple-theme.md
└── complex-theme/
├── _index.md
├── sub-topic-1.md
└── sub-topic-2.md
6. 進捗の追跡
質問を 3 ラウンド行うごとに、簡潔な進捗状況をユーザーに示します。
**Interview Progress:**
- Themes covered: X/Y
- Files created: N
- Current focus: <theme>
- Estimated remaining: ~Z more rounds
7. まとめと終了
すべてのテーマを扱い終えたとき(またはユーザーが終了の意思を示したとき):
_interview-index.mdを更新して、最終的な目次を記載します_summary.mdを作成し、学んだ内容を簡潔にまとめます- 不足している情報を特定し、
_open-questions.mdに一覧で記載します - 作成したファイルの総数、フォルダー構成、次のステップの提案をユーザーに伝えます
AskUserQuestion のベストプラクティス
- 1 回の呼び出しにつき質問は最大 2~3 個にします(ユーザーを圧倒しないようにします)
- 可能な場合は常に具体的な選択肢を提示します(ユーザーは引き続き「その他」と入力できます)
- 「次のうち、該当するものはどれですか?」という質問には
multiSelect: trueを使用します - ヘッダーは短くします(最大 12 文字)。チップ/タグとして表示されます
- 選択肢は曖昧にせず、明確に区別できるものにします
- 回答を受け取ったら、簡潔に応答してから書き込み、追加の質問をします
- 回答が短い場合は追加質問をし、詳しい場合は先に進みます。
アンチパターン
- しないでください:一度に10個の質問をすること。AskUserQuestion の呼び出し1回につき、最大3~4個にしてください
- しないでください:最後までファイルの書き込みを待つこと。段階的に書き込んでください
- しないでください:自由回答式の質問のほうが多くの情報を得られる場合に、はい/いいえで答える質問をすること
- しないでください:ユーザーがすでに回答した質問を繰り返すこと
- しないでください:知識があると決めつけること。必ずユーザーに確認してください
- しないでください:空のプレースホルダーファイルを作成すること。実際の内容がある場合にのみ書き込んでください