opsxshell/docs/sdd-template.md

# 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 |
| AC-UI | （可选） | UI 刀：对照设计过一遍观感 / 交互（图标、外链、确认条等） | 过线口径满足 | 目视或针对性测试 | Not Run |

UI 刀：在上表 FR→AC 加一行观感 / 交互过线口径即可（图标、外链、确认条等），不必另起设计专章。

## 6. 发布与恢复（S3 必填）

- 前置条件（配置、迁移、备份等）
- 发布顺序与健康检查
- 回滚或前向修复步骤
- 不可逆操作说明

## 7. 待决问题

| 问题 | 是否阻塞 | 推荐方案 |
| ---- | -------- | -------- |
|      |          |          |