用途
OneOS AutoPRD(oneos-autoprd)用于为 OneOS 业务模块生成产品经理可读、可评审、可排期的需求说明,并自动挂到 Axhub Make 标注工具的原型目录。它聚焦产品语义层面的描述,帮助产品经理在不阅读代码的情况下完成评审。
主要能力
- 按固定模板生成整模块 PRD,覆盖总览、目标、边界、角色、用户故事(起点→运作→闭环)、故事点、正逆向流程、流程图、关键逻辑、状态、风险、验收清单与交付口径。
- 在需求定稿 / 本轮定稿时,汇总功能变更并自动递增 PRD 版本号(V主.副.子;用户显式指定时以用户为准)。
- 与 YunxiaoPM 组合时,在设计完成或显式同步交付时,把 Markdown 写入【交付】任务描述。
- 修改原型(src/prototypes/<id>/ 下页面、交互、文案、判定、验收相关内容)时自动跟进,同一轮同步更新 PRD Markdown 与标注目录;纯样式且无产品语义变化可跳过全量重写。
- 支持入库前聊天/录音清洗:先 $AutoRDO,再由 YunxiaoPM 记录需求。
使用方式
主动调用关键词包括:AutoPRD、OneOS 需求说明、整模块 PRD、故事点 + 流程图、产品说明。
主流程(写/同步 PRD):
- 定模块:确定 OneOS 模块名与 src/prototypes/<prototype-id>/。
- 读上下文(只取产品语义):用户说明、已确认口径、原型标注、.spec/、业务条线说明(lines.ts);忽略实现细节,字段名/接口改写成业务语言。
- 收敛边界:做什么 / 不做什么、外部依赖、与其它模块关系。
- 按模板成文。
- 落盘 + 标注同步:写/更新 src/prototypes/<id>/.spec/requirements-prd.md;写/更新 src/resources/prd/<id>-autoprd.md;更新 annotation-source.json 顶层 directory.nodes(PRD 全文 + 推荐分章);若存在 scripts/sync-annotation-directory.mjs,执行之。
- 交付说明:路径、标注入口、故事点合计、开放问题/假设。
定稿流程见 references/release-changelog.md。云效需求「产品说明」见 references/yunxiao-description.md。云效【交付】回填(设计完成 · 非创建时)见 references/yunxiao-delivery-sync.md。
输出结构
完整模板见 references/template.md,章节包括:
-
- 一句话与目标
-
- 模块边界(最重要)
-
- 用户与角色
-
- 用户故事与故事点(业务条线说明口径)
-
- 功能模块说明(正向 / 逆向)
-
- 关键业务逻辑(必须对齐)
-
- 总览流程图
-
- 验收清单
-
- 交付口径
-
- 功能变更记录(定稿维护;含 V主.副.子)
对象存储预览链接形态为 {baseUrl}/{prototype-id}/index.html(禁止加 prototypes/ 前缀、禁止去掉 index.html)。
适用场景
- 为 OneOS 业务模块编写整模块 PRD。
- 修改原型后需要同步更新 PRD 与标注目录。
- 需求定稿时汇总变更并递增版本号。
- 与 YunxiaoPM 组合,在设计完成或同步交付时回填【交付】任务描述。
限制与约束
- 不写数据库表、字段名、接口路径、代码路径、组件名、存储 key;变更记录不写样式/UI/表结构优化。
- 用户故事以业务条线说明(lease-business-line-overview / lines.ts)为真相源,主叙述为起点 → 怎么运作 → 闭环,不用「作为…我希望…」宽表作主叙述。
- 旧包 yunxiao-requirement-lifecycle 已下架勿加载;云效状态机与【交付】/【分析】/【设计】树只由 YunxiaoPM 负责,本 Skill 不建同名无前缀阶段任务。
- 跨 Skill 逻辑交接只向 YunxiaoPM 传递正式 Skill 名、需求/交付任务编号、PRD 版本、正文或对象存储证据标识;不得传递安装位置,禁止定位或读取其他 Skill 的安装目录。下一跳只能输出正式选择器 $YunxiaoPM。
- 创建【交付】时不写 PRD 正文(占位由 YunxiaoPM 写入);设计完成或口令「同步交付说明」时按 yunxiao-delivery-sync.md 用任务编号回填【交付】。
- 与 YunxiaoPM 组合为唯一云效组合。
参考
- 定稿与版本: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
- 云效组合(唯一):$YunxiaoPM
- 入库清洗:$AutoRDO