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

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-28 15:50:35 +08:00
parent b14425da5a
commit 5d51a6bf7a
1393 changed files with 488042 additions and 10046 deletions
--- a/.claude/skills/oneos-autoprd/SKILL.md
+++ b/.claude/skills/oneos-autoprd/SKILL.md
@@ -1,146 +1,108 @@
 ---
 name: oneos-autoprd
 description: >-
-  Generates and keeps in sync OneOS AutoPRD (PM-facing requirements) plus Axhub
-  Make annotation directory Markdown/PRD; on 需求定稿/定稿/确认定稿/本次定稿 appends
-  functional release changelog below the PRD since last baseline. When a Yunxiao
-  requirement advances to 分析中/设计中/待开发, creates a same-titled linked task
-  (tag+create-time follow the requirement; 分析中/设计中 assignee=creator, 待开发
-  assignee=何斐). Use eagerly for prototypes, AutoPRD, or Yunxiao requirement
-  description/更新内容/stage advance—do not skip annotation sync, 定稿 changelog,
-  or stage-task creation.
+  OneOS AutoPRD: generates PM-facing requirements (总览/目标/边界/角色/用户故事
+  起点→运作→闭环/故事点/正逆向/流程图/关键逻辑/状态/风险/交付) and syncs Axhub Make
+  annotation PRD. On 需求定稿/本轮定稿 appends functional changelog with auto
+  V主.副.子 (user 主/副/子 override wins). With YunxiaoPMapp design-complete,
+  writes Markdown into 【交付】 by task number (not at create; placeholder until then).
+  Use for AutoPRD, prototypes, 产品说明, 本轮定稿. Never create same-titled stage
+  tasks; never load yunxiao-requirement-lifecycle—cloud combo is YunxiaoPMapp only.
 ---

-# OneOS AutoPRD
+# AutoPRD（oneos-autoprd）

 为 OneOS 业务模块生成**产品经理可读、可评审、可排期**的需求说明，并**自动挂到 Axhub Make 标注工具 → 原型目录**。

-另支持：**需求定稿**时汇总功能/逻辑变更记录；与云效组合时提供「需求说明 + 更新内容」；需求进入**分析中 / 设计中 / 待开发**时**自动创建与需求同名的关联任务**（规则见下，写在本 Skill，不改云效 Skill）。
+另支持：**本轮定稿 / 需求定稿**时汇总功能变更并**自动递增 PRD 版本号**；与 **`$YunxiaoPMapp`** 组合时，在**设计完成**（或显式同步交付）把 Markdown 写入【交付】任务描述。

-颗粒度对齐「保险采购」全模块 PRD：讲清做什么、谁用、故事点、正逆向、流程图与关键业务逻辑；**不写**表结构、接口、字段代码名、文件路径、实现清单。
+**禁止加载** `yunxiao-requirement-lifecycle`。云效状态机与【交付】/【分析】/【设计】树**只**由 YunxiaoPMapp 负责；本 Skill **不**建同名无前缀阶段任务。
+
+颗粒度：讲清做什么、谁用、故事点、正逆向、流程图与关键业务逻辑；**不写**表结构、接口、字段代码名、文件路径、实现清单。

 ## 何时使用（含自动触发）

-**主动调用时**
+**主动调用**

- AutoPRD、OneOS 需求说明、整模块 PRD、故事点 + 流程图
+- AutoPRD、OneOS 需求说明、整模块 PRD、故事点 + 流程图、产品说明

-**改原型时必须自动跟进（全局规则）**
+**改原型时必须自动跟进**

- 正在修改 `src/prototypes/<id>/` 下页面、交互、文案、判定、验收相关内容
- 同一轮交付内同步更新 PRD Markdown + 标注目录，不得只改代码
+- 修改 `src/prototypes/<id>/` 下页面、交互、文案、判定、验收相关内容
+- 同一轮同步更新 PRD Markdown + 标注目录；**纯样式且无产品语义变化可跳过全量重写**

 **需求定稿时（强制）**

- 用户回复含：`需求定稿` / `定稿` / `确认定稿` / `本次定稿`
- 执行 [references/release-changelog.md](references/release-changelog.md)：写第 10 章 + 更新基线
+- 关键字：`需求定稿` / `定稿` / `确认定稿` / `本次定稿` / **`本轮定稿`**
+- 执行 [references/release-changelog.md](references/release-changelog.md)：第 10 章 + `prdVersion` 基线

-**云效建需求 / 完善需求时（强制组合）**
+**与 YunxiaoPMapp 组合（强制 · 唯一云效组合）**

- 与 `$yunxiao-requirement-lifecycle` 一起使用时：先跑本 Skill，再写云效描述
- **需求说明** ← PRD 正文（或浓缩交付口径 + 关键章节）
- **更新内容** ← 第 10 章中**自上次定稿以来**的条目（无增量则「首版定稿 / 本轮无功能增量」）
-
-**云效需求推进至分析中 / 设计中 / 待开发时（强制）**
-
- 无论口令来自本 Skill 还是云效 Skill，只要本轮把需求推到上述状态，就执行 [references/yunxiao-stage-tasks.md](references/yunxiao-stage-tasks.md)
- 自动建**与需求同名**的任务并正式关联；标签与创建时间口径沿用需求；分析中/设计中负责人=创建人，待开发负责人=**何斐**
-
-不要用本 Skill 替代：需求探索访谈、设计比稿、纯样式微调（无产品语义变化时可跳过全量重写）。
+- 设计完成或完善「产品说明」：先本 Skill 落盘 MD，再由 YunxiaoPMapp / 本 Skill 按 [yunxiao-description.md](references/yunxiao-description.md) 写入需求 `## 产品说明（AutoPRD）`（**不覆盖** `## 原始诉求（AutoRDO）` / `## 工作项编号（系统）`）
+- **创建【交付】时不写 PRD 正文**（占位由 YunxiaoPMapp 写入）；设计完成或口令「同步交付说明」时按 [yunxiao-delivery-sync.md](references/yunxiao-delivery-sync.md) 用任务**编号**回填【交付】
+- 入库前聊天/录音清洗：先 `$AutoRDO`，再 YunxiaoPMapp 记录需求

 ## 工作流

 ### 主流程（写/同步 PRD）

-1. **定模块**：确认 OneOS 模块名与 `src/prototypes/<prototype-id>/`。
+1. **定模块**：OneOS 模块名与 `src/prototypes/<prototype-id>/`。
 2. **读上下文（只取产品语义）**  
   - 用户说明、已确认口径、原型标注、`.spec/`、业务条线说明（`lines.ts`）  
   - 忽略实现细节；字段名/接口改写成业务语言。
 3. **收敛边界**：做什么 / 不做什么、外部依赖、与其它模块关系。
-4. **按模板成文**：下方「输出结构」；缺关键信息最多问 1～2 个问题，其余写「假设」。
-5. **落盘 + 标注同步（强制）** — 见 [references/annotation-sync.md](references/annotation-sync.md)。
+4. **按模板成文**：见「输出结构」与 [references/template.md](references/template.md)。
+5. **落盘 + 标注同步（强制）** — [references/annotation-sync.md](references/annotation-sync.md)。

   | 顺序 | 动作 |
   |------|------|
   | A | 写/更新 `src/prototypes/<id>/.spec/requirements-prd.md` |
   | B | 写/更新 `src/resources/prd/<id>-autoprd.md` |
-   | C | 更新 `annotation-source.json` **顶层** `directory.nodes`（PRD 全文 + 推荐分章）；禁止只写 `data.directory` |
+   | C | 更新 `annotation-source.json` **顶层** `directory.nodes`（PRD 全文 + 推荐分章） |
   | D | 若存在 `scripts/sync-annotation-directory.mjs`，执行之 |

-6. **交付说明**：路径、标注目录入口、故事点合计、开放问题/假设。
+6. **交付说明**：路径、标注入口、故事点合计、开放问题/假设。

-### 定稿流程（关键字触发）
+### 定稿流程

-见 [references/release-changelog.md](references/release-changelog.md)。摘要：
+见 [references/release-changelog.md](references/release-changelog.md)。含自动 `V主.副.子`；**用户显式指定主/副/子时以用户为准**。

-1. 读 PRD + `.spec/autoprd-baseline.json`
-2. 汇总自上次定稿以来的**功能/逻辑**变更（排除样式/UI/表结构）
-3. 追加到 `## 10. 功能变更记录`（最新在上）
-4. 更新基线 JSON + 标注目录
-5. 若同时发云效：本次定稿块 →「更新内容」；旧段 →「更新内容·历史」
+### 云效需求「产品说明」（与 YunxiaoPMapp 双段模板）

-### 云效交接格式（给 yunxiao skill 直接粘贴）
+见 [references/yunxiao-description.md](references/yunxiao-description.md)。

-```markdown
-## 原型链接
-<对象存储或预览 URL>
+### 云效【交付】回填（设计完成 · 非创建时）

-## 需求说明
-<AutoPRD 正文或交付口径 + 必要章节>
-
-## 更新内容
-<第 10 章本次定稿块；无则「首版定稿」或「本轮无功能/逻辑增量」>
-
-## 更新内容·历史
-<以往更新内容倒序，勿删除>
-```
-
-### 云效阶段任务（状态推进时强制）
-
-见 [references/yunxiao-stage-tasks.md](references/yunxiao-stage-tasks.md)。摘要：
-
-| 需求状态 | 任务标签 | 负责人 | 标题 |
-|----------|----------|--------|------|
-| 分析中 | 分析 | 需求创建人 | 与需求同名 |
-| 设计中 | 设计 | 需求创建人 | 与需求同名 |
-| 待开发 | 交付（或开发） | 何斐 | 与需求同名 |
-
-正式关联需求；创建时间口径沿用需求；同阶段未取消任务不重复建。
+见 [references/yunxiao-delivery-sync.md](references/yunxiao-delivery-sync.md)。

 ## 写作硬约束

-**必须写**
+**必须写（映射用户概要）**

- 一句话定位 + 目标 / 非目标
- 模块边界（含 mermaid 总览更好）
- 角色与目标（角色名优先对齐业务条线说明）
- **用户故事**（业务条线说明口径）+ Epic 级**故事点（SP）**粗估
- 分功能**正向**与**逆向/边界**
- 至少 1～2 个 **mermaid** 流程图
- **关键业务逻辑**（业务话）
- 验收清单 + 「交付口径」一段话
- 定稿后：**功能变更记录**（第 10 章）
+| 概要能力 | 落在章节 |
+|---|---|
+| 总览 | §1 一句话与目标 |
+| 目标 / 边界 | §1–2 |
+| 角色 | §3 |
+| 用户故事（起点→运作→闭环）+ 故事点 | §4 |
+| 正逆向流程 | §5 |
+| 关键逻辑 / 状态 / 风险 | §6（及验收相关） |
+| 流程图 | §7 |
+| 交付 | §9 交付口径 |
+| 定稿变更 | §10 |
+
+另：验收清单 §8；对象存储预览链接形态 `{baseUrl}/{prototype-id}/index.html`（禁止加 `prototypes/` 前缀、禁止去掉 `index.html`）。

 **禁止写**

 - 数据库表、字段名、接口路径、代码路径、组件名、存储 key
- 研发实现指令（可写「正式环境由审批中心回写」这类业务依赖）
- 在变更记录里写样式/UI/表结构优化
+- 变更记录里的样式/UI/表结构优化
+- 引导加载 `yunxiao-requirement-lifecycle` 或「同名阶段任务」建单

 ## 用户故事口径（强制 · 对齐业务条线说明）

-真相源：原型 **业务条线说明**（`lease-business-line-overview` / `lines.ts`）。  
-每条能力用「责任部门 → **起点** → **怎么运作** → **闭环**」叙述；**不要**用「作为…我希望…」宽表作主叙述。
-
-| 块 | 写什么 |
-|----|--------|
-| 角色 | 谁负责、谁协同 |
-| 起点 | 谁在什么前提下启动 |
-| 怎么运作 | 有序步骤，含跨角色协作 |
-| 关键结果 | 可选标签 |
-| 闭环 | 业务终点与可追溯性 |
-
-可选：`US-xx`、压缩句「作为…我想…以便…」、规模 S/M/L 或 SP（仅排期，不替代主叙述）。
+真相源：业务条线说明（`lease-business-line-overview` / `lines.ts`）。  
+主叙述：**起点 → 怎么运作 → 闭环**（不要用「作为…我希望…」宽表作主叙述）。

 ## 输出结构

@@ -158,26 +120,27 @@ description: >-
 ## 7. 总览流程图
 ## 8. 验收清单
 ## 9. 交付口径
-## 10. 功能变更记录   ← 定稿后维护；日常改原型不强制每改必写
+## 10. 功能变更记录   ← 定稿维护；含 V主.副.子
 ```

 ## 质量自检

 - [ ] 产品经理不看代码也能评审
 - [ ] 用户故事为起点 / 怎么运作 / 闭环
- [ ] `.spec/requirements-prd.md` 已更新
- [ ] 标注目录「产品需求说明（PRD）」已同步且正文一致
- [ ] 定稿时：第 10 章 + `autoprd-baseline.json` 已更新
- [ ] 推进至分析中/设计中/待开发时：同名任务已创建或复用，正式关联，负责人正确
- [ ] 无表结构 / 接口 / 代码路径；变更记录无样式/UI 废话
+- [ ] `.spec/requirements-prd.md` + 标注目录已同步
+- [ ] 定稿时：第 10 章含版本号 + `autoprd-baseline.json` 含 `prdVersion`
+- [ ] 与 YunxiaoPMapp 设计完成：【交付】按**编号**回填，创建时未提前灌 MD
+- [ ] 全文无 `yunxiao-requirement-lifecycle` 引导；无同名阶段任务建单
+- [ ] 变更记录无样式/UI/表结构废话

 ## 参考

- 定稿变更日志：[references/release-changelog.md](references/release-changelog.md)
- 云效阶段任务：[references/yunxiao-stage-tasks.md](references/yunxiao-stage-tasks.md)
- 标注同步细则：[references/annotation-sync.md](references/annotation-sync.md)
- 章节模板：[references/template.md](references/template.md)
+- 定稿与版本：[references/release-changelog.md](references/release-changelog.md)
+- 云效产品说明：[references/yunxiao-description.md](references/yunxiao-description.md)
+- 【交付】回填：[references/yunxiao-delivery-sync.md](references/yunxiao-delivery-sync.md)
+- 标注同步：[references/annotation-sync.md](references/annotation-sync.md)
+- 模板：[references/template.md](references/template.md)
 - 故事示例：[references/granularity-example.md](references/granularity-example.md)
 - 业务条线：`src/prototypes/lease-business-line-overview/lines.ts`
- 复杂判定规格：配合项目规则 `business-logic-documentation`
- 云效组合：`$yunxiao-requirement-lifecycle`（建需求时先本 Skill）
+- 云效组合（唯一）：`$YunxiaoPMapp`
+- 入库清洗：`$AutoRDO`
--- a/.claude/skills/oneos-autoprd/references/release-changelog.md
+++ b/.claude/skills/oneos-autoprd/references/release-changelog.md
@@ -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 章并刷新版本与基线。
--- a/.claude/skills/oneos-autoprd/references/template.md
+++ b/.claude/skills/oneos-autoprd/references/template.md
@@ -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
+
+判定=<主|副|子|用户指定·…>：<一行依据>

 - 「<能力名>」：<做了什么 / 逻辑如何变>
 - …
--- a/.claude/skills/oneos-autoprd/references/yunxiao-delivery-sync.md
+++ b/.claude/skills/oneos-autoprd/references/yunxiao-delivery-sync.md
@@ -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 建同名任务
--- a/.claude/skills/oneos-autoprd/references/yunxiao-description.md
+++ b/.claude/skills/oneos-autoprd/references/yunxiao-description.md
@@ -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`
--- a/.claude/skills/oneos-autoprd/references/yunxiao-stage-tasks.md
+++ b/.claude/skills/oneos-autoprd/references/yunxiao-stage-tasks.md
@@ -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 文档，再改状态，再按本文件建任务（负责人何斐）。