mcpField
D
deep-interview

deep-interview

github.com/aviz85生産性5074 回インストール16 週間前に更新
リポジトリ

deep-interview について

的を絞った質問で知識を段階的に引き出し、回答を随時記録するアダプティブなインタビュースキルです。テーマ別ファイルや進捗管理、最終的な要約を通じて、整理されたナレッジベースの作成を支援します。

主な機能

  1. 01テーマに応じたアダプティブな質問
  2. 02各ラウンド後の回答記録
  3. 03テーマ別ファイルへの整理
  4. 04インタビューの進捗管理
  5. 05要約と未解決の質問の作成

活用シーン

  1. 01複雑なテーマに関する専門知識の記録
  2. 02複数ラウンドにわたる構造化インタビュー記録の作成
  3. 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 個)を特定します。各テーマについて:

  1. <theme-slug>.md ファイルを作成します
  2. AskUserQuestion を使って、そのテーマに関する的を絞った質問を 2~4 個します
  3. 回答をテーマのファイルに書き込みます
  4. テーマが十分に複雑な場合は、サブファイルに分割するためのサブフォルダー <theme-slug>/ を作成します

深さごとの質問戦略:

深さテーマごとの質問数ラウンド合計出力ファイル数
浅め2-33-55-10
中程度4-66-1010-20
深め8-1212-2020-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. まとめと終了

すべてのテーマを扱い終えたとき(またはユーザーが終了の意思を示したとき):

  1. _interview-index.md を更新して、最終的な目次を記載します
  2. _summary.md を作成し、学んだ内容を簡潔にまとめます
  3. 不足している情報を特定し、_open-questions.md に一覧で記載します
  4. 作成したファイルの総数、フォルダー構成、次のステップの提案をユーザーに伝えます

AskUserQuestion のベストプラクティス

  • 1 回の呼び出しにつき質問は最大 2~3 個にします(ユーザーを圧倒しないようにします)
  • 可能な場合は常に具体的な選択肢を提示します(ユーザーは引き続き「その他」と入力できます)
  • 「次のうち、該当するものはどれですか?」という質問には multiSelect: true を使用します
  • ヘッダーは短くします(最大 12 文字)。チップ/タグとして表示されます
  • 選択肢は曖昧にせず、明確に区別できるものにします
  • 回答を受け取ったら、簡潔に応答してから書き込み、追加の質問をします
  • 回答が短い場合は追加質問をし、詳しい場合は先に進みます。

アンチパターン

  • しないでください:一度に10個の質問をすること。AskUserQuestion の呼び出し1回につき、最大3~4個にしてください
  • しないでください:最後までファイルの書き込みを待つこと。段階的に書き込んでください
  • しないでください:自由回答式の質問のほうが多くの情報を得られる場合に、はい/いいえで答える質問をすること
  • しないでください:ユーザーがすでに回答した質問を繰り返すこと
  • しないでください:知識があると決めつけること。必ずユーザーに確認してください
  • しないでください:空のプレースホルダーファイルを作成すること。実際の内容がある場合にのみ書き込んでください

コメント