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