# 功能变更记录（定稿触发）+ 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 章并刷新版本与基线。