OneOS1.2/.cursor/skills/oneos-autoprd/SKILL.md

name, description

name

description

oneos-autoprd

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.

AutoPRD（oneos-autoprd）

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

另支持：本轮定稿 / 需求定稿时汇总功能变更并自动递增 PRD 版本号；与 $YunxiaoPMapp 组合时，在设计完成（或显式同步交付）把 Markdown 写入【交付】任务描述。

禁止加载 yunxiao-requirement-lifecycle。云效状态机与【交付】/【分析】/【设计】树只由 YunxiaoPMapp 负责；本 Skill 不建同名无前缀阶段任务。

颗粒度：讲清做什么、谁用、故事点、正逆向、流程图与关键业务逻辑；不写表结构、接口、字段代码名、文件路径、实现清单。

何时使用（含自动触发）

主动调用

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

改原型时必须自动跟进

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

需求定稿时（强制）

• 关键字：需求定稿 / 定稿 / 确认定稿 / 本次定稿 / 本轮定稿
• 执行 references/release-changelog.md：第 10 章 + prdVersion 基线

与 YunxiaoPMapp 组合（强制 · 唯一云效组合）

• 设计完成或完善「产品说明」：先本 Skill 落盘 MD，再由 YunxiaoPMapp / 本 Skill 按 yunxiao-description.md 写入需求 ## 产品说明（AutoPRD）（不覆盖 ## 原始诉求（AutoRDO） / ## 工作项编号（系统））
• 创建【交付】时不写 PRD 正文（占位由 YunxiaoPMapp 写入）；设计完成或口令「同步交付说明」时按 yunxiao-delivery-sync.md 用任务编号回填【交付】
• 入库前聊天/录音清洗：先 $AutoRDO，再 YunxiaoPMapp 记录需求

工作流

主流程（写/同步 PRD）

1. 定模块：OneOS 模块名与 src/prototypes/<prototype-id>/。

2. 读上下文（只取产品语义）

   • 用户说明、已确认口径、原型标注、.spec/、业务条线说明（lines.ts）
   • 忽略实现细节；字段名/接口改写成业务语言。

3. 收敛边界：做什么 / 不做什么、外部依赖、与其它模块关系。

4. 按模板成文：见「输出结构」与 references/template.md。

5. 落盘 + 标注同步（强制） — 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 全文 + 推荐分章）
   D	若存在 scripts/sync-annotation-directory.mjs，执行之

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

定稿流程

见 references/release-changelog.md。含自动 V主.副.子；用户显式指定主/副/子时以用户为准。

云效需求「产品说明」（与 YunxiaoPMapp 双段模板）

见 references/yunxiao-description.md。

云效【交付】回填（设计完成 · 非创建时）

见 references/yunxiao-delivery-sync.md。

写作硬约束

必须写（映射用户概要）

概要能力	落在章节
总览	§1 一句话与目标
目标 / 边界	§1–2
角色	§3
用户故事（起点→运作→闭环）+ 故事点	§4
正逆向流程	§5
关键逻辑 / 状态 / 风险	§6（及验收相关）
流程图	§7
交付	§9 交付口径
定稿变更	§10

另：验收清单 §8；对象存储预览链接形态 {baseUrl}/{prototype-id}/index.html（禁止加 prototypes/ 前缀、禁止去掉 index.html）。

禁止写

• 数据库表、字段名、接口路径、代码路径、组件名、存储 key
• 变更记录里的样式/UI/表结构优化
• 引导加载 yunxiao-requirement-lifecycle 或「同名阶段任务」建单

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

真相源：业务条线说明（lease-business-line-overview / lines.ts）。
主叙述：起点 → 怎么运作 → 闭环（不要用「作为…我希望…」宽表作主叙述）。

输出结构

完整模板：references/template.md。

# <模块名> · 产品需求说明（全模块）

## 1. 一句话与目标
## 2. 模块边界（最重要）
## 3. 用户与角色
## 4. 用户故事与故事点（业务条线说明口径）
## 5. 功能模块说明（正向 / 逆向）
## 6. 关键业务逻辑（必须对齐）
## 7. 总览流程图
## 8. 验收清单
## 9. 交付口径
## 10. 功能变更记录   ← 定稿维护；含 V主.副.子

质量自检

• 产品经理不看代码也能评审
• 用户故事为起点 / 怎么运作 / 闭环
• .spec/requirements-prd.md + 标注目录已同步
• 定稿时：第 10 章含版本号 + autoprd-baseline.json 含 prdVersion
• 与 YunxiaoPMapp 设计完成：【交付】按编号回填，创建时未提前灌 MD
• 全文无 yunxiao-requirement-lifecycle 引导；无同名阶段任务建单
• 变更记录无样式/UI/表结构废话

参考

• 定稿与版本：references/release-changelog.md
• 云效产品说明：references/yunxiao-description.md
• 【交付】回填：references/yunxiao-delivery-sync.md
• 标注同步：references/annotation-sync.md
• 模板：references/template.md
• 故事示例：references/granularity-example.md
• 业务条线：src/prototypes/lease-business-line-overview/lines.ts
• 云效组合（唯一）：$YunxiaoPMapp
• 入库清洗：$AutoRDO