09 — 变更影响分析规范
📦 来源：
wl-skills-designv0.11.1 ·standards/09-change-impact.md· 可判定条目由verify（[M] 机械项）自动执行。
目标：把设计变更从“人工记忆同步”升级为“先分析影响，再补丁更新，最后复验闭环”。
一、适用范围
当用户提出以下需求时使用本规范：
- 已有设计文档上新增、删除、重命名字段
- spec 处理逻辑、状态机、按钮、校验规则发生变化
- 数据库表字段、枚举、索引、状态值发生变化
- 接口请求/响应字段、错误码、幂等、安全规则发生变化
- 原型页面字段、按钮显隐、交互状态发生变化
- 术语词典需要新增或统一命名
本规范不直接替代各单域生成规范；它负责跨产物影响判断和补丁计划。
二、变更输入结构
每次分析必须先形成一条变更登记：
| 项 | 必填 | 说明 |
|---|---|---|
| 变更编号 | 是 | CHG-YYYYMMDD-序号 |
| 变更来源 | 是 | 业务需求 / 评审问题 / 开发反馈 / 测试缺陷 |
| 变更对象 | 是 | 字段 / 状态 / 按钮 / 流程 / 表 / 接口 / 页面 / 词条 |
| 变更动作 | 是 | 新增 / 修改 / 删除 / 重命名 / 拆分 / 合并 |
| 当前描述 | 否 | 变更前内容 |
| 目标描述 | 是 | 变更后内容 |
| 涉及模块 | 是 | 模块名、功能编码、页面编码、接口编码等 |
| 已知文档路径 | 否 | spec / DB / API / prototype / glossary 路径 |
缺少“变更对象、变更动作、目标描述”时，不得继续分析，先追问。
三、影响域
| 域 | 检查重点 | 常见补丁 |
|---|---|---|
| spec | IPO 字段、处理逻辑、状态机、画面对照、内部接口 | 更新功能章节、IPO、状态机、画面对照 |
| glossary | 中英文名、枚举值、编码、同义词 | 新增词条、合并同义词、统一字段英文名 |
| DB | 表字段、类型长度、索引、默认值、枚举、历史字段 | 新增/修改字段、索引、DDL、数据字典 |
| API | 请求/响应字段、错误码、幂等键、安全说明 | 更新接口定义、OpenAPI、错误码 |
| prototype | 页面字段、按钮、显隐规则、字典编码、状态文案 | 更新页面标注、交互规则、data-* 锚点 |
| review | P0/P1 问题、追溯矩阵、评分 | 重新执行集成评审 |
四、影响传播规则
字段变更
glossary 字段词条
→ spec IPO 字段
→ DB 数据字典 / DDL
→ API 请求响应字段
→ prototype 字段标注
→ design-review 追溯矩阵状态机变更
spec 状态机
→ glossary 枚举
→ DB 枚举默认值 / 约束
→ API 状态字段 / 错误码
→ prototype 按钮显隐 / 标签文案
→ review P0/P1 门禁接口变更
API 字段 / 错误码 / 幂等
→ spec 内部接口与处理逻辑
→ DB 字段落库或查询来源
→ prototype 操作按钮和反馈文案
→ review IF-X / D4 复验原型变更
prototype 字段 / 按钮
→ spec IPO 字段和处理逻辑
→ glossary 字段词条
→ DB/API 是否需要承载
→ review PT-X / D4 复验五、输出格式
每次必须输出以下 5 段：
- 变更登记：按第二节表格填写
- 影响矩阵：按域列出影响等级、原因、需改文件、责任 Skill
- 补丁任务清单：按 P0/P1/P2 排序，明确先后依赖
- 建议执行顺序：指定应调用哪些已发布 Skill 复验
- 阻断项：列出无法继续的缺失文档或歧义输入
六、影响等级
| 等级 | 含义 | 处理要求 |
|---|---|---|
| P0 | 不同步会导致开发不可用或数据不一致 | 必须先修复再交付 |
| P1 | 会导致评审失败或字段追溯断裂 | 本轮必须修复 |
| P2 | 文档质量、说明完整性、体验一致性问题 | 可排入后续补丁 |
| NA | 无影响 | 说明判断依据 |
七、补丁任务格式
| 优先级 | 任务 | 文件 | 责任 Skill | 前置依赖 | 完成标准 |
|---|---|---|---|---|---|
| P0/P1/P2 | 动词开头 | 相对路径 | manifest 中的 Skill id | 依赖任务编号 | 可验证条件 |
任务必须能被执行，禁止只写“完善文档”“同步相关内容”。
八、闭环流程
[阶段1] 生成影响矩阵
↓
[阶段2] 验证影响覆盖：spec / glossary / DB / API / prototype / review 是否逐域判断
↓ 有缺口？
[阶段3] 修复补丁计划：补齐遗漏域、依赖顺序、责任 Skill
↓
[阶段4] 复验：P0/P1 均有任务或 NA 理由 → ✅ DONE九、验证清单（CI-A/B/C/X）
CI-A 输入完整性
- [ ] A01 变更对象明确
- [ ] A02 变更动作明确
- [ ] A03 目标描述明确
- [ ] A04 涉及模块或功能编码明确
CI-B 影响覆盖
- [ ] B01 spec 已判断
- [ ] B02 glossary 已判断
- [ ] B03 DB 已判断
- [ ] B04 API 已判断
- [ ] B05 prototype 已判断
- [ ] B06 review 已判断
CI-C 补丁可执行
- [ ] C01 每个 P0/P1 影响都有补丁任务
- [ ] C02 每个补丁任务有文件路径
- [ ] C03 每个补丁任务有责任 Skill
- [ ] C04 任务依赖顺序无循环
- [ ] C05 完成标准可验证
CI-X 跨文档一致性
- [ ] X01 字段变更使用 glossary 作命名锚点
- [ ] X02 状态变更同步 spec 状态机、DB 枚举、API 字段、prototype 显隐
- [ ] X03 接口变更回写 spec 内部接口和 DB 来源
- [ ] X04 原型新增字段不越过 spec/glossary 直接进入页面
- [ ] X05 最终建议包含对应 validate prompt 或 design-review 复验
十、修复协议
发现失败项时按以下顺序修复：
- A 组缺失：先追问用户，不得猜测
- B 组缺失：补齐影响域判断
- C 组缺失：把笼统建议拆成可执行任务
- X 组缺失：补跨文档联动和复验入口
有 A01/A02/A03 失败时，状态必须为“阻断”；有 P0/P1 未形成补丁任务时，状态必须为“需修复”。