Files
th-hotel-simple/docs/import/reusable/ai-native-templates/SPEC.template.md
T
2026-09-09 15:47:32 +08:00

2.3 KiB
Raw Blame History

Feature Spec 标题

项 内容
状态 Draft / Approved / Implemented / Superseded / Archived
日期 YYYY-MM-DD
负责人 按实际填写
需求来源 用户 / 客户 / 业务方 / 内部发现
关联 Change Request 可为空

1. 背景

说明为什么要做这个功能。

2. 目标

  • 目标 1:
  • 目标 2:

3. 非目标

  • 不做事项 1:
  • 不做事项 2:

4. 第一版范围与后续加固

  • 第一版必须完成的功能闭环:
  • 第一版必须保留的基础安全底线:Secret 管理 / 基础权限边界 / 输入校验 / 敏感日志控制 / 数据隔离 / 错误响应脱敏
  • 本阶段后置的高级安全、高并发、性能、完整可观测性、复杂扩展性或容灾能力:
  • 为后续迭代保留的低耦合边界和扩展点:

5. 用户与场景

说明谁会使用这个能力,在哪些场景使用。

6. Definition of Ready

  • 需求来源已确认:
  • 目标和非目标已确认:
  • 第一版范围、基础安全底线和后续加固项已确认:
  • 影响范围已确认:
  • 权限、安全、审计和数据边界已确认:
  • 前后端 / 测试分工已确认:
  • 未确认问题已列出:

7. 业务规则

  • 规则 1:
  • 规则 2:

8. 接口或交互契约

说明请求、响应、权限、安全、审计和兼容性要求。

9. 需求追踪表

需求项 后端状态 前端状态 测试状态 文档位置 当前状态
需求 1 Pending / Done / N/A Pending / Done / N/A Pending / Done / Blocked Draft / Approved / Implemented

10. 验收标准

  • Given / When / Then:
  • Given / When / Then:

11. 测试范围

  • 单元测试:
  • 集成测试:
  • 手工验证:
  • 本阶段未覆盖的高并发、安全加固、性能或可观测性验证:

12. Definition of Done

  • 实现满足 Spec:
  • 测试已运行或说明无法运行原因:
  • 需求追踪表已更新:
  • Project State 已更新:
  • 接口、安全、权限、审计、集成契约已同步:
  • 后续加固项已记录,不被误标为已完成:
  • 无 Secret、真实数据、构建产物或无关本地变更:

13. 文档更新

完成后检查 Domain、Architecture、Workflow、ADR、Project State 是否需要更新。