扩展氢能站点、加氢记录与台账原型链路,新增工作台、车辆资产 H5、自营物流等原型,并同步导航注册、PRD 资源与交付技能。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
王冕
2026-07-21 17:15:39 +08:00
parent e39df1c7c8
commit a01d2ab708
242 changed files with 102296 additions and 4866 deletions

View File

@@ -0,0 +1,183 @@
---
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
为 OneOS 业务模块生成**产品经理可读、可评审、可排期**的需求说明,并**自动挂到 Axhub Make 标注工具 → 原型目录**。
另支持:**需求定稿**时汇总功能/逻辑变更记录;与云效组合时提供「需求说明 + 更新内容」;需求进入**分析中 / 设计中 / 待开发**时**自动创建与需求同名的关联任务**(规则见下,写在本 Skill不改云效 Skill
颗粒度对齐「保险采购」全模块 PRD讲清做什么、谁用、故事点、正逆向、流程图与关键业务逻辑**不写**表结构、接口、字段代码名、文件路径、实现清单。
## 何时使用(含自动触发)
**主动调用时**
- AutoPRD、OneOS 需求说明、整模块 PRD、故事点 + 流程图
**改原型时必须自动跟进(全局规则)**
- 正在修改 `src/prototypes/<id>/` 下页面、交互、文案、判定、验收相关内容
- 同一轮交付内同步更新 PRD Markdown + 标注目录,不得只改代码
**需求定稿时(强制)**
- 用户回复含:`需求定稿` / `定稿` / `确认定稿` / `本次定稿`
- 执行 [references/release-changelog.md](references/release-changelog.md):写第 10 章 + 更新基线
**云效建需求 / 完善需求时(强制组合)**
-`$yunxiao-requirement-lifecycle` 一起使用时:先跑本 Skill再写云效描述
- **需求说明** ← PRD 正文(或浓缩交付口径 + 关键章节)
- **更新内容** ← 第 10 章中**自上次定稿以来**的条目(无增量则「首版定稿 / 本轮无功能增量」)
**云效需求推进至分析中 / 设计中 / 待开发时(强制)**
- 无论口令来自本 Skill 还是云效 Skill只要本轮把需求推到上述状态就执行 [references/yunxiao-stage-tasks.md](references/yunxiao-stage-tasks.md)
- 自动建**与需求同名**的任务并正式关联;标签与创建时间口径沿用需求;分析中/设计中负责人=创建人,待开发负责人=**何斐**
不要用本 Skill 替代:需求探索访谈、设计比稿、纯样式微调(无产品语义变化时可跳过全量重写)。
## 工作流
### 主流程(写/同步 PRD
1. **定模块**:确认 OneOS 模块名与 `src/prototypes/<prototype-id>/`
2. **读上下文(只取产品语义)**
- 用户说明、已确认口径、原型标注、`.spec/`、业务条线说明(`lines.ts`
- 忽略实现细节;字段名/接口改写成业务语言。
3. **收敛边界**:做什么 / 不做什么、外部依赖、与其它模块关系。
4. **按模板成文**:下方「输出结构」;缺关键信息最多问 12 个问题,其余写「假设」。
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` |
| D | 若存在 `scripts/sync-annotation-directory.mjs`,执行之 |
6. **交付说明**:路径、标注目录入口、故事点合计、开放问题/假设。
### 定稿流程(关键字触发)
见 [references/release-changelog.md](references/release-changelog.md)。摘要:
1. 读 PRD + `.spec/autoprd-baseline.json`
2. 汇总自上次定稿以来的**功能/逻辑**变更(排除样式/UI/表结构)
3. 追加到 `## 10. 功能变更记录`(最新在上)
4. 更新基线 JSON + 标注目录
5. 若同时发云效:本次定稿块 →「更新内容」;旧段 →「更新内容·历史」
### 云效交接格式(给 yunxiao skill 直接粘贴)
```markdown
## 原型链接
<对象存储或预览 URL>
## 需求说明
<AutoPRD 正文或交付口径 + 必要章节>
## 更新内容
<第 10 章本次定稿块;无则「首版定稿」或「本轮无功能/逻辑增量」>
## 更新内容·历史
<以往更新内容倒序,勿删除>
```
### 云效阶段任务(状态推进时强制)
见 [references/yunxiao-stage-tasks.md](references/yunxiao-stage-tasks.md)。摘要:
| 需求状态 | 任务标签 | 负责人 | 标题 |
|----------|----------|--------|------|
| 分析中 | 分析 | 需求创建人 | 与需求同名 |
| 设计中 | 设计 | 需求创建人 | 与需求同名 |
| 待开发 | 交付(或开发) | 何斐 | 与需求同名 |
正式关联需求;创建时间口径沿用需求;同阶段未取消任务不重复建。
## 写作硬约束
**必须写**
- 一句话定位 + 目标 / 非目标
- 模块边界(含 mermaid 总览更好)
- 角色与目标(角色名优先对齐业务条线说明)
- **用户故事**(业务条线说明口径)+ Epic 级**故事点SP**粗估
- 分功能**正向**与**逆向/边界**
- 至少 12 个 **mermaid** 流程图
- **关键业务逻辑**(业务话)
- 验收清单 + 「交付口径」一段话
- 定稿后:**功能变更记录**(第 10 章)
**禁止写**
- 数据库表、字段名、接口路径、代码路径、组件名、存储 key
- 研发实现指令(可写「正式环境由审批中心回写」这类业务依赖)
- 在变更记录里写样式/UI/表结构优化
## 用户故事口径(强制 · 对齐业务条线说明)
真相源:原型 **业务条线说明**`lease-business-line-overview` / `lines.ts`)。
每条能力用「责任部门 → **起点****怎么运作****闭环**」叙述;**不要**用「作为…我希望…」宽表作主叙述。
| 块 | 写什么 |
|----|--------|
| 角色 | 谁负责、谁协同 |
| 起点 | 谁在什么前提下启动 |
| 怎么运作 | 有序步骤,含跨角色协作 |
| 关键结果 | 可选标签 |
| 闭环 | 业务终点与可追溯性 |
可选:`US-xx`、压缩句「作为…我想…以便…」、规模 S/M/L 或 SP仅排期不替代主叙述
## 输出结构
完整模板:[references/template.md](references/template.md)。
```markdown
# <模块名> · 产品需求说明(全模块)
## 1. 一句话与目标
## 2. 模块边界(最重要)
## 3. 用户与角色
## 4. 用户故事与故事点(业务条线说明口径)
## 5. 功能模块说明(正向 / 逆向)
## 6. 关键业务逻辑(必须对齐)
## 7. 总览流程图
## 8. 验收清单
## 9. 交付口径
## 10. 功能变更记录 ← 定稿后维护;日常改原型不强制每改必写
```
## 质量自检
- [ ] 产品经理不看代码也能评审
- [ ] 用户故事为起点 / 怎么运作 / 闭环
- [ ] `.spec/requirements-prd.md` 已更新
- [ ] 标注目录「产品需求说明PRD」已同步且正文一致
- [ ] 定稿时:第 10 章 + `autoprd-baseline.json` 已更新
- [ ] 推进至分析中/设计中/待开发时:同名任务已创建或复用,正式关联,负责人正确
- [ ] 无表结构 / 接口 / 代码路径;变更记录无样式/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/granularity-example.md](references/granularity-example.md)
- 业务条线:`src/prototypes/lease-business-line-overview/lines.ts`
- 复杂判定规格:配合项目规则 `business-logic-documentation`
- 云效组合:`$yunxiao-requirement-lifecycle`(建需求时先本 Skill