# AI 编码 spec.md 模板

```md
# 功能规格：<功能名称>

负责人：
状态：草稿 | 待评审 | 已批准
最近更新：

## 背景
- 哪个系统、用户或工作流会变化？
- 当前行为是什么？
- 为什么现在需要改？

## 目标
- 变更上线后应该出现什么行为？

## 非目标
- 这次工作明确不改什么？
- 哪些相邻功能、重构或策略决策不在范围内？

## 需求
1. 系统必须...
2. 用户必须能够...
3. 现有行为必须继续...

## 边界情况
- 空输入或缺失输入：
- 权限或角色不匹配：
- 重试、重复请求或幂等：
- 旧客户端或旧数据状态：

## 约束
- 允许修改的文件或服务：
- 公开 API 或数据库契约：
- 性能、安全、隐私或灰度约束：

## 未决问题
- [ ] 问题：
  负责人：
  必须在什么时间前解决：
```