184 lines
8.2 KiB
Markdown
184 lines
8.2 KiB
Markdown
---
|
||
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. **按模板成文**：下方「输出结构」；缺关键信息最多问 1～2 个问题，其余写「假设」。
|
||
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）**粗估
|
||
- 分功能**正向**与**逆向/边界**
|
||
- 至少 1～2 个 **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）
|