Spec Guides

每篇指南能给你什么

每篇指南遵循相同结构：先说明这个主题为什么重要（一段话），再给出一个可以直接复制进规格或 ticket 的示例，最后是覆盖边界情况、角色专属问题和决策规则的深度内容。设计目标是：在 Sprint 开始时打开，5 分钟内扫完，带着一个可落地的产出离开。

指南比博客文章刻意更短。博客文章深入解释某个实践背后的原理，指南优先给你清单或模板——附带足够的上下文让你能直接使用，而不必先读完理论部分。

如何在团队中使用这些指南

最有效的使用方式是在规格评审会前按角色分配：PM 读 PRD 转规格指南和范围清单，技术负责人读边界情况和 API 契约清单，QA 读验收标准示例和规格评审清单。每个人带着自己职责范围内的专属问题参会，而不是所有人审查同一个层面。

如果评审前不足 30 分钟，从规格评审清单开始——它是发现返工根源最快的方式：缺少回滚步骤、无法测试的验收标准、未确认的依赖项。

什么时候用指南，什么时候用模板

当你在回答问题时用指南："好的验收标准长什么样？"或"我最容易漏掉哪些边界情况？"当你准备好动手写时用模板：你知道要记录什么，只需要一个结构化的格式来填写。

大多数规格工作从指南开始——校准什么叫"写好了"——然后切换到模板来生成实际的产出物。本页指南都链接了对应的模板，可以在两者之间无缝切换。

从哪篇开始

如果团队跳过规格评审或因需求理解错误频繁返工：从规格评审清单开始。它在最短的时间内暴露最常见的缺口。

如果团队写了规格但 QA 测试阶段仍频繁发现问题：从验收标准示例开始——最常见的问题是写出了技术上正确但无法在不追问的情况下测试的标准。

如果使用 AI 编码工具但输出频繁偏离需求：从 AI Coding Prompt 模板开始。