Pre Flight Interview — Development skill for Claude Code

pre-flight-interview

[English](README_EN.md) | 简体中文

[](LICENSE) [](https://claude.com/claude-code) []() []()

**执行任务前，先访谈再动手。** 一个 Claude Code skill，让 agent 在执行多步方案前与你逐问逐答共同定案——每次只问一个问题、附互斥选项与 trade-off，把设计自由度全部收敛为显式决策，避免"按错误假设执行 → 返工"。

🤔 解决什么问题

LLM agent 接到任务后最常见的失败模式不是能力不足，而是**按错误假设一路狂奔**：收录范围猜错、文件形式选错、项目归属脑补错——返工的成本远高于事前多问三句。

但"把所有问题一次抛给用户"同样糟糕：用户面对 10 个问题无从下手，且其中一半本可以用工具自查，另一半会因前面的答案而作废。

本 skill 把方案制定变成一场**结构化访谈**：agent 先用工具自查掉一切可自查的事实，剩下的真决策点逐个提问，问完收束为决策汇总表，确认后才执行。

✨ 核心特性

• 🔍 摸底先行：访谈前先读文件、探 API、查数据结构——自己能用工具查到的绝不问用户，避免基于错误前提访谈
• ❓ 每次只问一个问题（铁律）：按"最根本、最阻塞"优先排序，前一答案动态改变后续问题
• 📐 选项化提问：每问附 2-4 个互斥选项，选项 = 名称 + 后果/trade-off + 推荐标记与理由；自由文本作答同样有效
• 🔄 动态调整：用户中途补充新事实 → 并入决策集，重新设计剩余问题，不硬走原清单
• 📋 收束确认门：全部决策理清后输出决策汇总表，用户确认前不执行
• 🚧 执行守界：严格按汇总表执行；未覆盖的执行层小决策自行定但逐项报告；方向性分歧必须回到访谈
• 🧠 留痕：任务完成后将稳定事实（项目约定、工作偏好）写入长期记忆，后续会话免重谈

🔄 六阶段流程

┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌────────┐
│ 摸底先行 │ → │ 逐问推进 │ → │ 动态调整 │ → │ 收束确认 │ → │ 执行守界 │ → │  留痕  │
│ 工具自查 │   │ 一次一问 │   │ 重设计   │   │ 汇总表   │   │ 不越权   │   │ 入记忆  │
└─────────┘   └─────────┘   └─────────┘   └─────────┘   └─────────┘   └────────┘

🚀 安装

git clone https://github.com/taotaoboom/pre-flight-interview.git ~/.claude/skills/pre-flight-interview

装入用户级目录 `~/.claude/skills/` 全局生效；或装入项目级 `.claude/skills/` 仅对单个项目生效。安装后在 Claude Code 中即可自动发现，无需手动注册。

💬 触发方式

两条入口，满足其一即进入访谈流程：

1. 显式触发：对 agent 说"访谈式""每次问一个""我们讨论一下""先定方案""一起搞一下"
2. agent 提议：任务涉及多步方案设计、新功能、架构决策、需求模糊时，agent 会主动提议："这个任务有几个关键决策点，要访谈式逐个过一遍吗？"——你否决则按常规直接执行

纯执行性任务（改 bug、按既定方案操作、问答咨询）不会触发。

📸 访谈示例

以"为某 LLM 网关