新增 AutoRDO 需求清洗工作台与消息中枢，迭代 OneOS V2 设计规范及租赁合同/工作台/车辆等原型，同步云效技能与导航注册；并归档一批 legacy 原型快照。
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
王冕
@@ -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. 更新基线 JSON；annotation-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 主流程增量更新第 1–9 章；**不必**每改一次就写第 10 章。
|
||||
- **用户说定稿时**：才汇总写入第 10 章并刷新基线。
|
||||
- **改原型过程中**：增量更新第 1–9 章；**不必**每改一次写第 10 章。
|
||||
- **用户说定稿时**：才汇总第 10 章并刷新版本与基线。
|
||||
|
||||
@@ -2,6 +2,22 @@
|
||||
|
||||
复制下列结构填写。方括号为占位。**第 4 章用户故事必须用业务条线说明口径。**
|
||||
|
||||
## 概要能力 → 章节映射
|
||||
|
||||
| 用户概要 | 本模板位置 |
|
||||
|---|---|
|
||||
| 总览 | §1 一句话与目标 |
|
||||
| 目标 / 边界 | §1–2 |
|
||||
| 角色 | §3 |
|
||||
| 用户故事（起点→运作→闭环）/ 故事点 | §4 |
|
||||
| 正逆向流程 | §5 |
|
||||
| 状态 / 风险 / 关键逻辑 | §6（可分小节写状态机与风险） |
|
||||
| 流程图 | §7 |
|
||||
| 交付 | §9 |
|
||||
| 定稿变更与版本 | §10（见 release-changelog） |
|
||||
|
||||
状态与风险也可在 §6 下设 `### 状态` / `### 风险` 短节，避免另起大结构推翻存量 PRD。
|
||||
|
||||
```markdown
|
||||
# <模块名> · 产品需求说明（全模块）
|
||||
|
||||
@@ -110,7 +126,9 @@ flowchart TB
|
||||
> 产品经理原型发版记录。仅记功能与业务逻辑变更；不含样式/UI/表结构。
|
||||
> 由「需求定稿」关键字触发追加；日常改原型不强制每改必写。详见 [release-changelog.md](release-changelog.md)。
|
||||
|
||||
### 定稿 · YYYY-MM-DD
|
||||
### 定稿 · V{x.y.z} · YYYY-MM-DD
|
||||
|
||||
判定=<主|副|子|用户指定·…>：<一行依据>
|
||||
|
||||
- 「<能力名>」：<做了什么 / 逻辑如何变>
|
||||
- …
|
||||
|
||||
@@ -0,0 +1,47 @@
|
||||
# 【交付】任务描述回填（设计完成 · 按编号）
|
||||
|
||||
与 **`$YunxiaoPMapp`** 组合。创建【交付】时描述保持占位 `等待设计任务完成后自动填入`；**本文件只在设计完成（或显式同步）时**把 AutoPRD Markdown 写入【交付】。
|
||||
|
||||
**禁止**按任务标题查找交付；**禁止**加载 `yunxiao-requirement-lifecycle`。
|
||||
|
||||
## 触发时机
|
||||
|
||||
| 时机 | 动作 |
|
||||
|---|---|
|
||||
| YunxiaoPMapp **设计完成**且 AutoPRD 落盘成功 | 必须回填【交付】描述 |
|
||||
| 口令 `同步交付说明：交付任务=ONEOS-xx`（或需求编号可反查交付） | 按编号回填 |
|
||||
| 仅创建【交付】 / 分析中 / 设计中尚未设计完成 | **不**写 PRD 正文 |
|
||||
|
||||
## 前置
|
||||
|
||||
1. 已有【交付】任务编号：口令显式 > 需求 `## 工作项编号（系统）` > ASSOCIATED 反查校验。
|
||||
2. 冲突或缺少编号 → 停下询问；禁止按 `【交付】`+标题猜。
|
||||
3. 本地已有 `requirements-prd.md`（或本轮刚生成）。
|
||||
|
||||
## 写入内容
|
||||
|
||||
- 用与需求「产品说明（AutoPRD）」一致的正文**替换**占位文案。
|
||||
- 推荐：原型链接 + `requirements-prd.md` 全文（或 YunxiaoPMapp 约定的产品说明正文）。
|
||||
- 可附一句：`原始诉求见需求描述「原始诉求（AutoRDO）」`。
|
||||
- 不要删除或改写需求侧 AutoRDO 段（本步骤只改**任务**描述）。
|
||||
|
||||
## 执行顺序（设计完成组合）
|
||||
|
||||
```text
|
||||
1. AutoPRD 落盘 MD + 标注同步
|
||||
2. 更新需求「产品说明（AutoPRD）」
|
||||
3. 按交付任务编号 PATCH 任务描述（替换占位）
|
||||
4. 附件（ZIP/截图）由 YunxiaoPMapp make-export 流程负责；本文件不替代附件
|
||||
5. 任一步失败 → 不得声称交付说明已更新 / 设计完成材料齐全
|
||||
```
|
||||
|
||||
## 回报
|
||||
|
||||
- 交付任务编号、是否已替换占位、MD 路径
|
||||
- 失败时列出缺项（无编号 / 无 MD / 写入失败）
|
||||
|
||||
## 负向
|
||||
|
||||
- 创建交付当下灌入未完成的 PRD
|
||||
- 按标题 list 复用「像交付的任务」
|
||||
- 引导旧 lifecycle 建同名任务
|
||||
@@ -0,0 +1,60 @@
|
||||
# 云效需求描述：产品说明（对接 YunxiaoPMapp）
|
||||
|
||||
发云效 / 完善需求描述时，与 **`$YunxiaoPMapp`** 双段模板对齐。
|
||||
**禁止加载** `yunxiao-requirement-lifecycle`。
|
||||
|
||||
## 需求描述固定结构（不可互相覆盖）
|
||||
|
||||
```markdown
|
||||
## 原始诉求（AutoRDO）
|
||||
（由 AutoRDO 清洗；设计完成也不删除；本 Skill 不覆盖本段）
|
||||
|
||||
## 产品说明（AutoPRD）
|
||||
（本 Skill 写入：原型链接 + requirements-prd 正文或等价产品说明）
|
||||
|
||||
## 工作项编号（系统）
|
||||
（由 YunxiaoPMapp 维护；本 Skill 不改本段）
|
||||
```
|
||||
|
||||
## 产品说明段推荐拼装
|
||||
|
||||
```markdown
|
||||
## 产品说明（AutoPRD）
|
||||
|
||||
### 原型链接
|
||||
<{baseUrl}/{prototype-id}/index.html；禁止加 prototypes/ 前缀；禁止去掉 index.html>
|
||||
无则写「待发布」
|
||||
|
||||
### 需求说明
|
||||
<src/prototypes/<id>/.spec/requirements-prd.md 全文原样粘贴；禁止摘要顶替>
|
||||
|
||||
### 更新内容
|
||||
<第 10 章最新定稿块；无则「首版定稿」或「本轮无功能/逻辑增量」>
|
||||
|
||||
### 更新内容·历史
|
||||
<旧更新内容倒序；勿删>
|
||||
```
|
||||
|
||||
若 YunxiaoPMapp 本轮只要求「产品说明」短写：至少包含原型链接 + MD 全文或与交付回填一致的正文；**仍禁止**覆盖 AutoRDO / 工作项编号段。
|
||||
|
||||
## 真相源文件
|
||||
|
||||
1. `src/prototypes/<prototype-id>/.spec/requirements-prd.md`（主）
|
||||
2. 否则 `src/resources/prd/<prototype-id>-autoprd.md`
|
||||
|
||||
先 Read 文件再写入；不要凭记忆重写。
|
||||
|
||||
## 执行步骤
|
||||
|
||||
1. 确认 prototype-id 与需求编号（若写云效）。
|
||||
2. 读 MD 全文。
|
||||
3. PATCH/更新需求描述时**只改**「产品说明（AutoPRD）」相关内容；保留原始诉求与工作项编号。
|
||||
4. 若同时设计完成：按 [yunxiao-delivery-sync.md](yunxiao-delivery-sync.md) 回填【交付】。
|
||||
5. 回报：需求编号、MD 路径、是否全文写入、是否已回填交付编号。
|
||||
|
||||
## 禁止
|
||||
|
||||
- 只用第 9 章摘要顶替全文（除非用户只要链接）
|
||||
- 二次删减章节、去掉 mermaid/表格却声称全文已写
|
||||
- 创建【交付】时灌入 PRD（须等设计完成；见交付回填）
|
||||
- 引用或配合 `yunxiao-requirement-lifecycle`
|
||||
@@ -1,44 +0,0 @@
|
||||
# 云效阶段任务自动创建（AutoPRD 负责）
|
||||
|
||||
本规则写在 **oneos-autoprd**，不依赖改写 `yunxiao-requirement-lifecycle`。
|
||||
凡本 Skill 参与的云效操作中，需求推进到下列状态时，**同一轮必须**建同名任务并正式关联需求。
|
||||
|
||||
## 触发状态
|
||||
|
||||
| 需求推进至 | 任务标签（右侧基础字段） | 负责人 | 任务标题 |
|
||||
|------------|--------------------------|--------|----------|
|
||||
| **分析中** | `分析` | **需求创建人**姓名 | 与需求标题**完全同名** |
|
||||
| **设计中** | `设计` | **需求创建人**姓名 | 与需求标题**完全同名** |
|
||||
| **待开发** | `交付`（若项目无「交付」标签则用 `开发`） | **何斐** | 与需求标题**完全同名** |
|
||||
|
||||
## 强制字段与关系
|
||||
|
||||
1. **正式关联需求**：父子或关联项；只挂标题不算关联。创建后必须在界面上能看到需求 ↔ 任务关系。
|
||||
2. **标签**：写入任务「标签」基础字段（见上表）；标题前缀不能代替标签。
|
||||
3. **创建时间沿用需求**：任务的创建时间（及标签侧可见的创建时间口径）尽量与**需求创建时间**一致。
|
||||
- 平台允许改创建时间 / 用 API 指定时：写成需求的创建时间。
|
||||
- 平台不允许：在任务描述首行注明 `创建时间口径=需求创建时间（YYYY-MM-DD HH:mm）`，并在回报里说明「平台限制未改系统创建时间」。
|
||||
4. **幂等**：同一需求、同一阶段标签下，已存在**未取消**且已正式关联的同名任务 → **不新建**，只校验负责人/标签/关联是否正确，缺则补齐。
|
||||
5. **顺序**：先确认需求已进入目标状态（或本轮动作将写入该状态），再创建/补齐任务；回报时给出任务编号与链接。
|
||||
|
||||
## 执行步骤（apply 时）
|
||||
|
||||
```text
|
||||
1. 读取需求：标题、创建人、创建时间、当前/目标状态、已关联任务列表
|
||||
2. 按上表确定本轮阶段标签与负责人
|
||||
3. 查重（需求ID + 阶段标签 + 未取消）
|
||||
4. 无则创建：标题=需求标题；标签=阶段标签；负责人=上表；创建时间口径=需求创建时间；正式关联需求
|
||||
5. 有则校验并修补标签/负责人/关联
|
||||
6. 回报：需求状态、任务编号、负责人、是否新建/复用
|
||||
```
|
||||
|
||||
## 不在本规则内
|
||||
|
||||
- 不自动建「测试 / 发版」任务（除非用户另行要求）。
|
||||
- 不因样式类 PRD 变更触发建任务；仅**需求状态**进入分析中/设计中/待开发时触发。
|
||||
- 云效生命周期细则、流水线、缺陷闭环仍可由 `$yunxiao-requirement-lifecycle` 配合执行；**本建任务逻辑以 AutoPRD 本文为准**。
|
||||
|
||||
## 与定稿 / 需求说明的关系
|
||||
|
||||
- 写「需求说明 / 更新内容」仍按 AutoPRD 主流程与定稿流程。
|
||||
- 推进到待开发且需要描述时：先 AutoPRD 文档，再改状态，再按本文件建任务（负责人何斐）。
|
||||
Reference in New Issue
Block a user