用途:将软件需求规格(SRS)与功能需求规格(FRS)标准化,定义技术层面的“如何实现”,并为每条需求建立可验证的映射关系。适用于编写 SRS 等需求文档场景。
主要能力:
- SRS/FRS 发现:确认关联 PRD 需求(REQ-)与验收标准 ID(AC-),维护 BRD-OBJ-* -> REQ-* -> AC-* -> SRS-* -> 测试证据的追踪链;当 REQ-* 或 AC-* 输入缺失时阻断或退回 PRD 流程,不依据代码推断产品范围。
- 定义功能流程:触发、输入、校验、输出、错误;复杂流程按一参与者、一目标、一会话拆分正常、替代与异常路径。
- 定义接口契约:API、事件、存储、外部集成。
- 定义非功能需求阈值:延迟、可用性、安全性、可扩展性。
- 定义约束:迁移、兼容性、合规、发布。
使用方式:加载 references/srs-template.md;沿用源文档 docs/prd/prd-[slug].md 的同一 [slug] 以保持文件名级可追溯;为每条陈述编写需求卡片,分配稳定的 SRS-* ID,并映射到源 PRD REQ-* 与验证通道;每条技术行为映射到 PRD 验收标准、测试通道与证据目标;包含陈述、优先级、状态、输入/输出/错误行为、NFR 影响、测量方法与证据目标;附加结果报告(feature_status、需求追踪、已完成/缺失证据、待决策项、推荐下一步工作流);写入 docs/srs/srs-[slug].md。
验证映射:每条 SRS-* 需有测试证据计划(单元/集成/E2E/手动);明确失败模式与回退行为;权限与隐私控制映射到需求;每条 NFR 需有测量方法。
限制与反模式:不得在同一陈述中混合需求与实现任务;NFR 不得缺少数值阈值;接口契约不得缺少输入/输出/错误模式;需求不得缺少源追踪与验证链接;不得在未映射 PRD 验收标准 ID 与测试通道的情况下移交实现;复杂交互不得仅有正常路径。官方文本未提供更多细节。