# Spec Interview

> 进行深入访谈以收集需求并编写详细的规格说明书 (spec)

- Skill: `4thfever/spec-interview` (Agent Skill)
- Install (CLI): `npx skillmds@latest add 4thfever/spec-interview`
- Raw SKILL.md: https://api.skillmd.com/api/skills/4thfever/spec-interview/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: 4thfever (https://skillmd.com/u/4thfever)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/4thfever/spec-interview

---


## 概述

使用 `AskUserQuestion` 进行深入的访谈，在编写规格说明书之前深入理解一个功能、系统或想法。

## 核心原则

1. **运用你的判断力** - 根据主题调整问题的深度和重点。一个小的 UI 更改需要的问题与一个新的认证系统不同。

2. **问非显而易见的问题** - 跳过表面问题。探究：
   - 用户尚未表达的隐藏假设
   - 他们尚未考虑的边缘情况
   - 他们隐式做出的权衡
   - 他们忘记提及的约束条件
   - 故障模式和恢复路径

3. **跟随有趣的线索** - 当答案揭示了复杂性或不确定性时，在继续之前深入挖掘。

4. **温和地挑战** - 问“如果 X 失败了怎么办？”或“为什么不改用 Y？”来对设计进行压力测试。

5. **知道何时停止** - 当你有足够的清晰度来编写有用的规格说明书时结束访谈。并非每个主题都需要详尽的覆盖。

## 问题领域（根据需要使用，而不是作为清单）

- **问题与动机**：为什么是现在？不这样做的代价是什么？
- **技术设计**：数据模型、状态、API、性能、数据迁移
- **用户体验**：错误状态、加载、边缘情况、无障碍访问
- **集成**：这还会影响什么？安全性？可观测性？
- **权衡**：你**不**构建什么？你接受了什么技术债务？
- **风险**：哪些假设可能是错的？什么会导致这个项目失败？

## 访谈流程

1. 每轮通过 `AskUserQuestion` 开始 2-4 个问题。
2. 综合答案并跟进空白或模糊之处。
3. 定期总结以确认理解。
4. 当足够完整时，与用户确认并编写规格说明书。

## 输出

将规格说明书写入 `docs/specs/<feature-name>.md`（或询问用户首选路径）。包含任何相关的部分——不要强求死板的模板。

## 调用

```
/spec-interview [主题]
```