docs(changelog): 对齐 changelog-conventions SKILL——模板补枚举/修改前后对比/影响评估三节,指南补受众判定/自包含/消费方语言等方法论
changelog-filename-gate / validate (push) Successful in 2s
changelog-filename-gate / validate (push) Successful in 2s
这个提交包含在:
@@ -154,6 +154,36 @@ base: "{dev|dev-v3}"
|
||||
|
||||
---
|
||||
|
||||
## 六.5、枚举 / 数据字典(接口出现枚举时必写)
|
||||
|
||||
每个枚举单独一个子节,不混表。字段+枚举类对应关系写在子节开头。
|
||||
|
||||
### {字段名}({枚举类全限定名})
|
||||
|
||||
**所属字段**: `{ReqVO/RespVO 字段名}` | **类型**: `String`
|
||||
|
||||
| 值 | 中文 | 说明 |
|
||||
|----|------|------|
|
||||
| `VALUE_A` | 中文名 | 触发条件/含义 |
|
||||
|
||||
## 六.6、修改前后对比(修改/删除类接口必写,新增跳过)
|
||||
|
||||
### 字段级对比
|
||||
|
||||
| 字段 | 改前 | 改后 |
|
||||
|------|------|------|
|
||||
|
||||
### 行为级对比
|
||||
|
||||
| 行为 | 改前 | 改后 |
|
||||
|------|------|------|
|
||||
|
||||
## 六.7、影响评估(修改/删除类必写)
|
||||
|
||||
- **是否破坏向后兼容**: 是 / 否
|
||||
- **前端是否必须同步上线**: 是 / 否
|
||||
- **前端 workaround 清理点**: {如"老前端按比例硬编码算定金的逻辑可撤",无则写"无"}
|
||||
|
||||
## 七、不影响范围(显式声明, 帮前端/QA 缩小排查面)
|
||||
|
||||
- **仅影响**: 管理后台 X 表单
|
||||
|
||||
在新工单中引用
屏蔽一个用户