96 lines
3.9 KiB
Markdown
96 lines
3.9 KiB
Markdown
# 功能变更记录（定稿触发）+ PRD 版本号
|
||
|
||
用户回复**定稿关键字**后，必须生成「自上次定稿以来」的功能变更日志，追加到 PRD **最下方**，按规则递增 **`prdVersion`（V主.副.子）**，并更新定稿基线。
|
||
|
||
## 触发关键字（命中任一）
|
||
|
||
`需求定稿` · `定稿` · `确认定稿` · `本次定稿` · **`本轮定稿`**
|
||
|
||
（可带模块名，如「保险采购本轮定稿」。可附带 `版本类型=主|副|子`。）
|
||
|
||
## 写什么 / 不写什么
|
||
|
||
| 要写（产品发版视角） | 不写 |
|
||
|----------------------|------|
|
||
| 哪个功能做了什么修改 | 布局、页面样式、UI 设计优化 |
|
||
| 变更了什么业务逻辑 / 流程 / 验收口径 | 「优化了哪些表」「改了哪些字段/接口」 |
|
||
| 用户可感知的交互结果变化 | 纯样式、动效、无语义文案微调 |
|
||
|
||
## 版本号 `V{主}.{副}.{子}`
|
||
|
||
基线字段 `prdVersion`（无则视为 `V0.0.0`）。有功能/逻辑增量时递增；**无增量则版本号不变**。
|
||
|
||
### 判定优先级
|
||
|
||
1. **用户覆盖（优先）**
|
||
口令或对话显式指定「主 / 副 / 子」→ **以用户为准**，不再自动改判。
|
||
定稿块首行写：`判定=用户指定·主`（或副/子）。
|
||
|
||
2. **自动判定（用户未指定时）**
|
||
- **主+1**（副→0，子→0）：跨模块边界变化、主流程/状态机重做、角色权限模型大改、验收口径整体推翻等「大改动」≥1 条主导。
|
||
- **副+1**（子→0）：能力增删改、逻辑/文案产品语义变化、故事点级功能优化（**默认多数定稿**）。
|
||
- **子+1**：仅小幅逻辑澄清；若用户明确「本轮定稿」且变更非空且未指定类型 → **至少副+1**（不用子）。
|
||
- 定稿块首行写：`判定=主：…` / `判定=副：…` / `判定=子：…`（须写依据，禁止无依据猜）。
|
||
|
||
3. **无功能增量**
|
||
版本号不变；正文写「本轮无功能/逻辑增量（仅样式或未达产品语义变更）」或「首版定稿」（无基线且首版可落到 `V1.0.0` 若视为首次发布——首版有实质内容时用主从 `V0.0.0`→`V1.0.0`）。
|
||
|
||
## 落点
|
||
|
||
1. **PRD 文末章节**
|
||
`src/prototypes/<id>/.spec/requirements-prd.md` → `## 10. 功能变更记录`
|
||
新定稿块插在该章**最上方**。
|
||
|
||
2. **定稿基线**
|
||
`src/prototypes/<id>/.spec/autoprd-baseline.json`
|
||
|
||
```json
|
||
{
|
||
"prototypeId": "insurance-procurement",
|
||
"prdVersion": "V1.2.0",
|
||
"lastConfirmedAt": "2026-07-21T12:00:00+08:00",
|
||
"lastConfirmedLabel": "定稿 · V1.2.0 · 2026-07-21",
|
||
"summaryBullets": ["…", "…"]
|
||
}
|
||
```
|
||
|
||
3. **标注目录**：同步「产品需求说明（PRD）」全文节点。
|
||
|
||
4. **云效**（若本轮走 YunxiaoPMapp）：按 [yunxiao-description.md](yunxiao-description.md) 更新需求产品说明；**禁止**加载 `yunxiao-requirement-lifecycle`。
|
||
|
||
## 定稿工作流
|
||
|
||
1. 确认 `<prototype-id>`。
|
||
2. 读 PRD 与 `autoprd-baseline.json`（无基线 → 首版；`prdVersion` 缺省 `V0.0.0`）。
|
||
3. 收集自 `lastConfirmedAt` 以来的产品语义变更；过滤样式/表结构。
|
||
4. 判定版本类型（用户指定优先）→ 计算新 `prdVersion`。
|
||
5. 追加 `### 定稿 · V{x.y.z} · YYYY-MM-DD`（首行判定理由 + 条目）。
|
||
6. 更新基线 JSON；annotation-sync。
|
||
7. 回报：新版本号、判定理由、条目数、PRD 路径。
|
||
|
||
## PRD 章节格式
|
||
|
||
```markdown
|
||
## 10. 功能变更记录
|
||
|
||
> 产品经理原型发版记录。仅记功能与业务逻辑变更；不含样式/UI/表结构。
|
||
|
||
### 定稿 · V1.2.0 · 2026-07-21
|
||
|
||
判定=副：新增比价失败明细可点开
|
||
|
||
- 「识别失败」：失败数可点击查看失败文件与原因
|
||
- …
|
||
|
||
### 定稿 · V1.1.0 · 2026-07-10
|
||
|
||
判定=用户指定·副
|
||
|
||
- …
|
||
```
|
||
|
||
## 与日常改原型的关系
|
||
|
||
- **改原型过程中**：增量更新第 1–9 章；**不必**每改一次写第 10 章。
|
||
- **用户说定稿时**：才汇总第 10 章并刷新版本与基线。
|