需求文档模板¶

目标：在项目开始前把“要解决什么问题、如何验收、什么不做”写清楚。

一、必须写清的 9 个问题¶

谁是用户？
真实痛点是什么？
当前替代方案是什么？
成功标准是什么？
输入输出是什么？
不做什么？
资源与时间约束是什么？
风险是什么？
第一版怎么验收？

二、推荐结构¶

Markdown

# 项目需求文档

## 1. 背景与目标
- 背景：
- 业务/学习目标：
- 为什么现在做：

## 2. 用户与场景
- 目标用户：
- 典型使用场景：
- 当前痛点：

## 3. 范围
### 3.1 本期纳入
- 
### 3.2 本期不做
- 

## 4. 输入与输出
- 输入：
- 输出：
- 关键约束：

## 5. 功能需求
| 编号 | 需求 | 优先级 | 验收方式 |
|------|------|--------|----------|
| FR-1 | | P0 | |
| FR-2 | | P1 | |

## 6. 非功能需求
| 维度 | 目标 |
|------|------|
| 延迟 | |
| 可用性 | |
| 成本 | |
| 安全 | |
| 可观测性 | |

## 7. 验收指标
| 指标 | Baseline | 目标值 | 说明 |
|------|----------|--------|------|
| | | | |

## 8. 风险与假设
- 风险：
- 假设：
- 预案：

## 9. 里程碑
- M1：
- M2：
- M3：

三、不同交付线的补充要求¶

AI 应用工程¶

额外写清：

用户任务链路
错答或幻觉的容忍边界
人工评审口径

AI 基础设施¶

额外写清：

目标模型规模
QPS / 并发目标
成本上限和硬件预算

数据与平台工程¶

额外写清：

数据规模与更新频率
数据时效要求
调用方和 SLA

四、常见问题¶

只写“我要做一个 Agent”不算需求定义。
没有 baseline 的目标值没有约束力。
没写“不做什么”，范围一定会失控。