SuperAPI AI 工具集

oneos-autoprd

办公与效率

查看项目

更新于 10-15 08:53

技能介绍

用途

OneOS AutoPRD(oneos-autoprd)用于为 OneOS 业务模块生成产品经理可读、可评审、可排期的需求说明,并自动挂到 Axhub Make 标注工具的原型目录。它聚焦产品语义层面的描述,帮助产品经理在不阅读代码的情况下完成评审。

主要能力

  • 按固定模板生成整模块 PRD,覆盖总览、目标、边界、角色、用户故事(起点→运作→闭环)、故事点、正逆向流程、流程图、关键逻辑、状态、风险、验收清单与交付口径。
  • 在需求定稿 / 本轮定稿时,汇总功能变更并自动递增 PRD 版本号(V主.副.子;用户显式指定时以用户为准)。
  • 与 YunxiaoPM 组合时,在设计完成或显式同步交付时,把 Markdown 写入【交付】任务描述。
  • 修改原型(src/prototypes/<id>/ 下页面、交互、文案、判定、验收相关内容)时自动跟进,同一轮同步更新 PRD Markdown 与标注目录;纯样式且无产品语义变化可跳过全量重写。
  • 支持入库前聊天/录音清洗:先 $AutoRDO,再由 YunxiaoPM 记录需求。

使用方式

主动调用关键词包括:AutoPRD、OneOS 需求说明、整模块 PRD、故事点 + 流程图、产品说明。

主流程(写/同步 PRD):

  1. 定模块:确定 OneOS 模块名与 src/prototypes/<prototype-id>/。
  2. 读上下文(只取产品语义):用户说明、已确认口径、原型标注、.spec/、业务条线说明(lines.ts);忽略实现细节,字段名/接口改写成业务语言。
  3. 收敛边界:做什么 / 不做什么、外部依赖、与其它模块关系。
  4. 按模板成文。
  5. 落盘 + 标注同步:写/更新 src/prototypes/<id>/.spec/requirements-prd.md;写/更新 src/resources/prd/<id>-autoprd.md;更新 annotation-source.json 顶层 directory.nodes(PRD 全文 + 推荐分章);若存在 scripts/sync-annotation-directory.mjs,执行之。
  6. 交付说明:路径、标注入口、故事点合计、开放问题/假设。

定稿流程见 references/release-changelog.md。云效需求「产品说明」见 references/yunxiao-description.md。云效【交付】回填(设计完成 · 非创建时)见 references/yunxiao-delivery-sync.md。

输出结构

完整模板见 references/template.md,章节包括:

    1. 一句话与目标
    1. 模块边界(最重要)
    1. 用户与角色
    1. 用户故事与故事点(业务条线说明口径)
    1. 功能模块说明(正向 / 逆向)
    1. 关键业务逻辑(必须对齐)
    1. 总览流程图
    1. 验收清单
    1. 交付口径
    1. 功能变更记录(定稿维护;含 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