| name | proj-change |
| description | 处理开发过程中的需求变更。用于开发过程中需求有调整、需要新增/删除/修改功能点、方案确认后发现遗漏。 |
需求变更
触发词
- "需求变了"
- "再加个字段"
- "这个不要了"
- "改一下"
执行流程
Step 0: 校验任务文档 → Step 1: 记录变更 → Step 2: 评估影响 → Step 3: 确认变更 → Step 4: 更新文档 → Step 5: 继续开发
Step 0: 校验任务文档
- 确认全流程任务文档存在
- 若缺失,先创建任务文档骨架并补齐流程状态与上下文快照
Step 1: 记录变更
## 变更记录
**变更类型:** 新增 / 修改 / 删除
**变更描述:** {具体描述}
**变更原因:** {为什么要改}
Step 2: 评估影响
## 影响分析
**影响范围:**
- [ ] 数据库表结构
- [ ] Entity 实体类
- [ ] Mapper
- [ ] Service
- [ ] DTO
- [ ] Controller
**影响文件:**
- 需修改:{文件列表}
- 需新增:{文件列表}
- 需删除:{文件列表}
**风险评估:**
- 是否影响已有数据:是/否
- 是否影响其他功能:是/否
Step 3: 确认变更
向用户确认:
Step 4: 更新文档
更新方案文档(如有)
## 变更记录
| 日期 | 变更内容 | 原因 |
|------|----------|------|
| 2025-01-15 | 新增 phone 字段 | 需要记录手机号 |
更新任务文档
仅记录变更状态、产物路径与下一步指令,不写实现细节
同步更新:
- 流程状态总览中标记“业务开发/任务拆分”为进行中
- 产物清单记录需求/方案文档更新路径
- 上下文快照记录“变更中”与风险/阻塞
- 下一步指令指向具体变更开发任务
常见变更影响
| 变更类型 | 影响范围 |
|---|
| 加字段 | 表结构、Entity、DTO |
| 改字段类型 | 表结构、Entity、DTO、Service |
| 加接口 | Service、Controller、可能需要新 DTO |
| 删功能 | 可能涉及多层代码删除 |
注意事项
- 先评估后执行 - 不要直接改代码
- 记录变更历史 - 在方案文档中记录
- 更新任务列表 - 变更产生的任务要加入列表(仅记录状态与简述)
- 标记变更任务 - 用
[变更] 前缀标识
- 注意数据兼容 - 涉及数据库的变更要考虑已有数据
- 任务文档同步 - 全程维护流程状态、产物清单、上下文快照、下一步指令