SDD 模板路径: docs/sdd-template.md
SDD 模板（S2 / S3 使用）
SDD-xxx：<功能名称>
| 字段 |
内容 |
| 版本 / 变更级别 |
0.1 / S2 或 S3 |
| 设计状态 |
Draft |
| 实现状态 |
Not Started |
| 负责人 / 日期 |
待指定 / YYYY-MM-DD |
| 关联需求 |
- |
| 批准状态 |
未批准 |
1. 背景、目标与范围
- 当前行为与证据：
- 本次目标：
- 非目标：
- 必须保留的行为：
2. 需求与约束
- FR-01：当 <条件> 时，系统必须 <行为>。
- NFR-01：<性能 / 安全 / 兼容要求及测量方式>
- 边界条件、异常场景、权限要求
3. 架构与方案
- 涉及模块及职责
- 关键数据流 / 调用关系
- 复用哪些现有能力
- 关键取舍及理由
- Agent 可自主决定的实现细节
4. 接口、数据与配置契约
（已有权威文件时直接引用路径，仅说明差异）
- 接口变更：
- 数据模型 / 迁移：
- 配置变更：
- 兼容性：
5. 风险与验收
风险
| 风险或失败场景 |
防护 / 降级 / 恢复 |
可观察信号 |
|
|
|
验收标准
| AC |
对应需求 |
前置条件与操作 |
预期结果 |
验证方式 |
结果 |
| AC-01 |
FR-01 |
|
|
|
Not Run |
6. 发布与恢复（S3 必填）
- 前置条件（配置、迁移、备份等）
- 发布顺序与健康检查
- 回滚或前向修复步骤
- 不可逆操作说明
7. 待决问题
细流程、状态机与规格索引见 docs/specs/README.md，长表用 docs/specs/_template.md。两套不并行发明第三份字段；S2/S3 起草可先填本短模板，评审入库时落到 docs/specs/<domain>/<slug>.md。
logan
9304b0e98c