s2f/cursor-rules/change-management.md

需求变更管理

本规则用于指导需求变更识别、影响评估、文档追加和任务闭环。

启用条件

• 当用户提出与已确认的 pmdocs/0-req-XXX.md、pmdocs/1-prd-XXX.md 或 pmdocs/2-task-XXX.md 不一致的要求时，先判断是否属于需求变更。
• 只有影响以下任一范围时，才启用完整变更机制：需求、PRD、任务、数据库、接口、权限、核心 UI 流程。
• 小变更不要过度文档化：文案调整、样式微调、明显 bug 修复、无业务含义的配置微调，不需要创建完整变更文档；可在任务记录或回复中简要说明。

核心原则

• 每次重要需求变更创建独立变更文档，不覆盖历史内容。
• 原始 pmdocs/0-req-XXX.md、pmdocs/1-prd-XXX.md、pmdocs/2-task-XXX.md 只追加版本标注和变更引用，不重写历史决策。
• 变更必须从"影响评估"进入"任务落地"，最后完成闭环。

变更文档命名

• 变更文档路径：pmdocs/changes/YYYY-MM-DD-序号-主题.md。
• 示例：pmdocs/changes/2026-07-05-001-权限码调整.md。
• 每份变更文档必须包含：背景、原因、目标、范围、影响评估、落地任务、状态、完成记录。

六步流程

1. 创建变更文档：pmdocs/changes/YYYY-MM-DD-序号-主题.md。
2. 评估影响：使用 7 维度影响评估表。
3. 更新原文档：在 pmdocs/0-req-XXX.md、pmdocs/1-prd-XXX.md、pmdocs/2-task-XXX.md 对应章节末尾追加 v{版本} 更新标注和变更文档引用。
4. 更新变更索引：在 pmdocs/CHANGELOG.md 追加变更记录。
5. 开发落地：按 pmdocs/2-task-XXX.md 新增任务执行，并关联变更文档。
6. 完成闭环：任务标记 [x]，变更文档状态标注完成，索引状态同步更新。

7 维度影响评估表

变更文档必须包含以下表格：

维度	是否影响	影响说明	处理动作	状态
需求	是/否	影响哪些 REQ 条目	追加版本标注 / 新增需求	待处理/已处理
PRD	是/否	影响哪些产品场景或功能	追加版本标注 / 调整优先级	待处理/已处理
任务	是/否	新增或调整哪些 TASK	追加任务 / 调整依赖	待处理/已处理
DB	是/否	表、字段、索引、迁移影响	新增 migration / 回滚方案	待处理/已处理
后端	是/否	API、服务、权限判断影响	修改接口 / 服务 / 测试	待处理/已处理
前端	是/否	页面、组件、状态、交互影响	修改页面 / 公共组件 / 测试	待处理/已处理
权限码	是/否	角色、权限码、访问边界影响	更新权限表 / 权限校验	待处理/已处理

原文档追加标注格式

在对应章节末尾追加：

📌 v{版本} 更新：见 pmdocs/changes/YYYY-MM-DD-序号-主题.md
影响范围：REQ-xxx、PRD-xxx、TASK-xxx
状态：已纳入 / 已完成 / 已废弃

确认要求

• 中大型变更执行前说明：影响范围、工作量、风险、回滚方案、需要回归测试的功能。
• 架构调整、多模块影响、数据结构或 API 破坏性变更，必须获得明确确认。
• 小规模明确变更可简要说明后直接执行。

变更文档模板

# CHG-YYYYMMDD-001：变更主题

## 背景
为什么要做这个变更

## 原因
用户需求 / 线上问题 / 技术债 / 架构调整

## 目标
变更期望达成的目标

## 范围
影响的功能模块、页面、接口、数据

## 影响评估

| 维度 | 是否影响 | 影响说明 | 处理动作 | 状态 |
|---|---|---|---|---|
| 需求 | 是/否 | ... | ... | 待处理/已处理 |
| PRD | 是/否 | ... | ... | 待处理/已处理 |
| 任务 | 是/否 | ... | ... | 待处理/已处理 |
| DB | 是/否 | ... | ... | 待处理/已处理 |
| 后端 | 是/否 | ... | ... | 待处理/已处理 |
| 前端 | 是/否 | ... | ... | 待处理/已处理 |
| 权限码 | 是/否 | ... | ... | 待处理/已处理 |

## 落地任务

- [ ] TASK-xxx：更新需求文档
- [ ] TASK-xxx：更新 PRD
- [ ] TASK-xxx：更新任务文档
- [ ] TASK-xxx：DB migration
- [ ] TASK-xxx：后端实现
- [ ] TASK-xxx：前端实现
- [ ] TASK-xxx：测试
- [ ] TASK-xxx：更新 CHANGELOG

## 风险与回滚

- 风险：...
- 回滚方案：...
- 需要回归测试的功能：...

## 完成记录

- 2026-07-05：创建变更文档
- 2026-07-06：完成影响评估，更新原文档
- 2026-07-08：完成开发和测试
- 2026-07-09：变更闭环