CtrlK
BlogDocsLog inGet started
Tessl Logo

spec-interview

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

64

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.cursor/skills/spec-interview/SKILL.md
SKILL.md
Quality
Evals
Security

概述

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

核心原则

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

  2. 问非显而易见的问题 - 跳过表面问题。探究:

    • 用户尚未表达的隐藏假设
    • 他们尚未考虑的边缘情况
    • 他们隐式做出的权衡
    • 他们忘记提及的约束条件
    • 故障模式和恢复路径
  3. 跟随有趣的线索 - 当答案揭示了复杂性或不确定性时,在继续之前深入挖掘。

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

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

问题领域(根据需要使用,而不是作为清单)

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

访谈流程

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

输出

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

调用

/spec-interview [主题]
Repository
4thfever/cultivation-world-simulator
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.