OneOS1.2/.claude/skills/oneos-autoprd/references/release-changelog.md

功能变更记录（定稿触发）+ 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

{
  "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-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 章节格式

## 10. 功能变更记录

> 产品经理原型发版记录。仅记功能与业务逻辑变更；不含样式/UI/表结构。

### 定稿 · V1.2.0 · 2026-07-21

判定=副：新增比价失败明细可点开

- 「识别失败」：失败数可点击查看失败文件与原因
- …

### 定稿 · V1.1.0 · 2026-07-10

判定=用户指定·副

- …

与日常改原型的关系

• 改原型过程中：增量更新第 1–9 章；不必每改一次写第 10 章。
• 用户说定稿时：才汇总第 10 章并刷新版本与基线。