新增 AutoRDO 需求清洗工作台与消息中枢,迭代 OneOS V2 设计规范及租赁合同/工作台/车辆等原型,同步云效技能与导航注册;并归档一批 legacy 原型快照。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
王冕
2026-07-28 15:50:35 +08:00
parent b14425da5a
commit 5d51a6bf7a
1393 changed files with 488042 additions and 10046 deletions

View File

@@ -1,12 +1,12 @@
# 功能变更记录(定稿触发)
# 功能变更记录(定稿触发)+ PRD 版本号
用户回复**需求定稿关键字**后,必须生成「自上次定稿以来」的功能变更日志,追加到 PRD **最下方**,并更新定稿基线。
用户回复**定稿关键字**后,必须生成「自上次定稿以来」的功能变更日志,追加到 PRD **最下方**按规则递增 **`prdVersion`V主.副.子)**并更新定稿基线。
## 触发关键字(命中任一)
`需求定稿` · `定稿` · `确认定稿` · `本次定稿`
`需求定稿` · `定稿` · `确认定稿` · `本次定稿` · **`本轮定稿`**
(可带模块名,如「保险采购需求定稿」。)
(可带模块名,如「保险采购本轮定稿」。可附带 `版本类型=主|副|子`
## 写什么 / 不写什么
@@ -16,44 +16,57 @@
| 变更了什么业务逻辑 / 流程 / 验收口径 | 「优化了哪些表」「改了哪些字段/接口」 |
| 用户可感知的交互结果变化 | 纯样式、动效、无语义文案微调 |
条目口吻示例:
## 版本号 `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 文末章节**(强制)
1. **PRD 文末章节**
`src/prototypes/<id>/.spec/requirements-prd.md``## 10. 功能变更记录`
新定稿块插在该章**最上方**(倒序:最新在上);历史块保留
新定稿块插在该章**最上方**。
2. **定稿基线**(强制)
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": "定稿 · 2026-07-21",
"lastConfirmedLabel": "定稿 · V1.2.0 · 2026-07-21",
"summaryBullets": ["…", "…"]
}
```
3. **标注目录**:同步更新「产品需求说明PRD」全文节点若有「PRD 分章」,增加或更新「功能变更记录」分章
3. **标注目录**同步「产品需求说明PRD」全文节点。
4. **云效交接**(若本轮同时走云效):把**本次定稿块**正文作为需求描述「更新内容」;旧「更新内容」挪到「更新内容·历史」
4. **云效**(若本轮走 YunxiaoPMapp按 [yunxiao-description.md](yunxiao-description.md) 更新需求产品说明;**禁止**加载 `yunxiao-requirement-lifecycle`
## 定稿工作流
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 路径;若需发云效,提示可用口令。
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. 更新基线 JSONannotation-sync
7. 回报新版本号、判定理由、条目数、PRD 路径
## PRD 章节格式
@@ -62,17 +75,21 @@
> 产品经理原型发版记录。仅记功能与业务逻辑变更;不含样式/UI/表结构。
### 定稿 · 2026-07-21
### 定稿 · V1.2.0 · 2026-07-21
- 「能力名」:做了什么 / 逻辑如何变
判定=副:新增比价失败明细可点开
- 「识别失败」:失败数可点击查看失败文件与原因
-
### 定稿 · 2026-07-10
### 定稿 · V1.1.0 · 2026-07-10
判定=用户指定·副
-
```
## 与日常改原型的关系
- **改原型过程中**按 AutoPRD 主流程增量更新第 19 章;**不必**每改一次写第 10 章。
- **用户说定稿时**:才汇总写入第 10 章并刷新基线。
- **改原型过程中**:增量更新第 19 章;**不必**每改一次写第 10 章。
- **用户说定稿时**:才汇总第 10 章并刷新版本与基线。