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 了解整体情况。每次最多提出 2-3 个宽泛问题。

第一次提问——明确访谈范围以及受访者与主题的关系：

  • 这个主题涉及什么？（如果不清楚）
  • 用户的角色／专业水平是什么？
  • 记录这些知识的目标是什么？

**重要：**每次 AskUserQuestion 获得回答后，都要立即将了解到的内容写入文件，然后再提出更多问题。不得在写入前累计超过一轮的回答。

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. 提问技巧

变换问题类型，以提取不同层次的知识：

  • 是什么类问题：事实、定义、组成部分
  • 如何做类问题：流程、工作流、方法
  • 为什么类问题：推理、理念、决策
  • 何时／何地类问题：背景、触发因素、条件
  • 谁类问题：利益相关者、受众、角色
  • 如果……会怎样类问题：边缘情况、例外、故障
  • 排序／优先级类问题：要求排定优先级（“选出前 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 最佳实践

  • 每次最多提出 2-3 个问题（避免让用户应接不暇）
  • 尽可能始终提供具体选项（用户仍可输入“其他”）
  • 对于“以下哪些适用？”类问题，使用 multiSelect: true
  • 标题保持简短（最多 12 个字符）——它们会显示为标签
  • 将选项表述为清晰、互不重复的选择，避免含糊
  • 收到回答后，先简短致谢，再写入内容并提出更多问题
  • 如果用户回答简短，继续追问；如果回答详尽，则进入下一步。

反模式

  • 不要一次问 10 个问题——每次调用 AskUserQuestion 最多问 3～4 个
  • 不要等到最后才写入文件——应逐步写入
  • 不要在开放式问题能获得更多信息时，提出是非题
  • 不要重复询问用户已经回答过的问题
  • 不要假定用户了解相关内容——务必向用户确认
  • 不要创建空的占位文件——只有在有实际内容时才写入

评论

支持 Markdown