个人实践
Spec 模板与验收条件
- 目标与非目标分开写,非目标用来挡住范围蔓延
- 约束写明技术栈、兼容范围和不可改动的接口
- 验收条件逐条编号,测试报告按编号对应
示例
# spec.md(节选) ## 目标 - 支持按时间窗查询设备巡检结果 ## 非目标 - 不做跨项目聚合 ## 验收条件 - [ ] 给定 3 台设备、7 天窗口,接口返回按设备分组的结果 - [ ] 窗口超过 31 天返回 400 与错误码 RANGE_TOO_LARGE - [ ] ./gradlew test --tests DeviceQueryTest 全部通过