# Spec Interview

> Spec Interview is an Agent Skill for business published in the 4thfever/cultivation-world-simulator repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

- Skill name: `spec-interview`
- Category: [Business](https://www.openparable.com/skill/business/1)
- Source: https://github.com/4thfever/cultivation-world-simulator/blob/HEAD/.cursor/skills/spec-interview/SKILL.md
- Repository: 4thfever/cultivation-world-simulator (1,937 GitHub stars when collected)

## SKILL.md

## 概述

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

## 核心原则

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

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

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

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

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

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

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

## 访谈流程

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

## 输出

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

## 调用

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

---

Source: https://www.openparable.com/skill/business/spec-interview (OpenParable). Cite the canonical URL above.
