3.0 KiB
3.0 KiB
功能变更记录(定稿触发)
用户回复需求定稿关键字后,必须生成「自上次定稿以来」的功能变更日志,追加到 PRD 最下方,并更新定稿基线。
触发关键字(命中任一)
需求定稿 · 定稿 · 确认定稿 · 本次定稿
(可带模块名,如「保险采购需求定稿」。)
写什么 / 不写什么
| 要写(产品发版视角) | 不写 |
|---|---|
| 哪个功能做了什么修改 | 布局、页面样式、UI 设计优化 |
| 变更了什么业务逻辑 / 流程 / 验收口径 | 「优化了哪些表」「改了哪些字段/接口」 |
| 用户可感知的交互结果变化 | 纯样式、动效、无语义文案微调 |
条目口吻示例:
- 「识别失败」:失败数可点击查看失败文件与原因;仅失败时也可打开明细
- 「比价单」:审批通过后仍须在保单管理另行录入正式保单(强调不自动同步)
落点
-
PRD 文末章节(强制)
src/prototypes/<id>/.spec/requirements-prd.md→## 10. 功能变更记录
新定稿块插在该章最上方(倒序:最新在上);历史块保留。 -
定稿基线(强制)
src/prototypes/<id>/.spec/autoprd-baseline.json
{
"prototypeId": "insurance-procurement",
"lastConfirmedAt": "2026-07-21T12:00:00+08:00",
"lastConfirmedLabel": "定稿 · 2026-07-21",
"summaryBullets": ["…", "…"]
}
-
标注目录:同步更新「产品需求说明(PRD)」全文节点;若有「PRD 分章」,增加或更新「功能变更记录」分章。
-
云效交接(若本轮同时走云效):把本次定稿块正文作为需求描述「更新内容」;旧「更新内容」挪到「更新内容·历史」。
定稿工作流
- 确认
<prototype-id>(从对话 / 打开文件 / 用户指名推断)。 - 读现有 PRD 与
autoprd-baseline.json(无基线则本轮视为首版定稿)。 - 收集自
lastConfirmedAt以来的产品语义变更:
对话确认口径 → 批注/操作说明 → PRD 新旧差异 →(可选)相关提交说明。
过滤掉样式/表结构类改动。 - 若无功能增量:仍写定稿块,正文为「本轮无功能/逻辑增量(仅样式或未达产品语义变更)」或「首版定稿」。
- 追加
### 定稿 · YYYY-MM-DD+ 条目列表到第 10 章顶部。 - 更新
autoprd-baseline.json;执行 annotation-sync。 - 向用户回报:基线时间、条目数、PRD 路径;若需发云效,提示可用口令。
PRD 章节格式
## 10. 功能变更记录
> 产品经理原型发版记录。仅记功能与业务逻辑变更;不含样式/UI/表结构。
### 定稿 · 2026-07-21
- 「能力名」:做了什么 / 逻辑如何变
- …
### 定稿 · 2026-07-10
- …
与日常改原型的关系
- 改原型过程中:按 AutoPRD 主流程增量更新第 1–9 章;不必每改一次就写第 10 章。
- 用户说定稿时:才汇总写入第 10 章并刷新基线。