name: interview description: 深度访谈完善技术规格文档
规格访谈技能
通过探究式访谈,将草稿规格转化为完整技术文档。
触发条件
- 关键词:向我采访、完善文档、请询问我、对我提出疑问、细化需求、访谈、interview、请interview我
- 场景:当用户有草稿规格文档需要完善,或需求边界不清晰需要深入挖掘时
核心规范
规范1:定位并读取文档
在开始访谈前,必须先定位用户指定的文档:
1. 询问用户目标文档路径(如 design.md、proposal.md)
2. 读取文档全文,理解当前内容
3. 识别文档中的模糊点、缺失项、待确认项
规范2:系统性提问
使用 AskUserQuestion 工具进行结构化访谈,覆盖以下维度:
- 技术实现细节:具体实现方式、技术选型依据
- UI/UX 设计决策:交互流程、视觉规范、用户体验
- 边缘情况与异常处理:错误处理、降级策略、极端输入
- 风险与权衡取舍:性能 vs 可维护性、安全 vs 便捷
- 架构决策依据:为什么选择这个方案而非其他
规范3:迭代深挖
- 每轮聚焦一个维度,避免一次性提问过多
- 问题要有深度,挖掘用户未明确表达的隐含需求
- 追问"为什么"而非仅接受"是什么"
- 持续迭代直到需求边界清晰(无遗漏、无冗余)
规范4:输出规格
访谈结束后,将完善内容写回原文档:
- 保留原文档结构,在对应位置补充细节
- 新增内容标注来源(如:[访谈补充])
- 生成变更摘要供用户确认
禁止事项
- ❌ 禁止在用户未确认前直接修改文档
- ❌ 禁止跳过访谈直接给出假设性答案
- ❌ 禁止忽略用户的”我不确定”回答(应引导其思考)
参考代码
- 规格文档模板:
openspec/changes/*/spec.md - 任务清单模板:
openspec/changes/*/tasks.md
检查清单
- 是否已读取并理解原文档内容
- 是否覆盖了所有关键维度(技术、UI、边缘、风险、架构)
- 是否挖掘了隐含需求而非仅记录表面回答
- 是否在修改前获得用户确认
- 是否生成了变更摘要