wang-q-l 产品 AI Agent 全流程编排
流程概览
完整流程（九个阶段）
用户输入想法
↓
[阶段0] 市场调研 → docs/market-research.md
↓
[阶段1] 用户画像 → docs/user-persona.md
↓
[阶段2] 功能优先级 → docs/feature-priority.md
↓
[阶段3] 产品路线图 → docs/roadmap.md
↓
[阶段4] 需求澄清 → docs/requirements.md
↓
[阶段5] 需求说明书 → docs/spec.md
↓
[阶段6] 前端原型 → src/ (完整项目代码)
↓
[阶段7] 测试用例 → docs/test-cases.md
↓
[阶段8] 操作手册 → docs/operation-manual.md
↓
[阶段9] 发版说明 → docs/release-notes.md
快速流程（五个阶段）
如果用户已有明确需求，可跳过前置阶段：
需求澄清 → 需求说明书 → 前端原型 → 测试用例 → 操作手册
每个阶段读取上一阶段的输出，保证内容一致性和上下文传递。
启动流程
Step 0: 初始化 — 了解全局信息
收到用户请求后，首先用 AskUserQuestion 一次性收集关键决策信息：
问题1：产品类型是什么？
- 管理后台系统（Vue3 + ElementPlus）
- 移动端 H5 应用（Vue3 + Vant）
- 企业官网（Vue3 + ElementPlus）
- 其他（请描述）
问题2：想走哪些阶段？
- 完整流程（市场调研 → 发版说明，共10个阶段）
- 快速流程（需求澄清 → 操作手册，共5个阶段）
- 只要文档（跳过前端原型代码生成）
- 自定义选择
问题3：现在手头有什么？
- 只有一个想法/描述（从市场调研开始）
- 已有市场调研报告（从用户画像开始）
- 已有明确需求（从需求澄清开始）
- 已有需求说明书（从原型开始）
收集完成后，立即用 TaskCreate 创建任务清单。
任务清单创建规范
根据用户选择的阶段，创建对应任务。示例（完整流程）：
TaskCreate: 阶段0 - 市场调研
TaskCreate: 阶段1 - 用户画像
TaskCreate: 阶段2 - 功能优先级排序
TaskCreate: 阶段3 - 产品路线图
TaskCreate: 阶段4 - 需求澄清
TaskCreate: 阶段5 - 需求说明书
TaskCreate: 阶段6 - 前端原型框架搭建
TaskCreate: 阶段6 - [模块A] 页面生成
TaskCreate: 阶段6 - [模块B] 页面生成
TaskCreate: 阶段7 - 测试用例
TaskCreate: 阶段8 - 操作手册
TaskCreate: 阶段9 - 发版说明
阶段0：市场调研
目标：分析市场规模、竞品情况、行业趋势，验证产品机会
执行方式：调用 pm-market-research skill
必须调研的内容：
- 市场规模分析（TAM/SAM/SOM）
- 目标用户群体特征
- 竞品分析（3-5个主要竞品）
- 行业趋势和机会点
- 差异化定位建议
输出：docs/market-research.md
# [产品名称] 市场调研报告
## 市场规模
- TAM（总体市场）：[规模估算]
- SAM（可服务市场）：[规模估算]
- SOM（可获得市场）：[规模估算]
## 目标用户
[用户群体特征、痛点、需求]
## 竞品分析
[竞品对比表格]
## 行业趋势
[趋势分析]
## 差异化定位
[建议的差异化方向]
完成标志：市场调研报告已写入 docs/market-research.md
阶段1：用户画像
目标：基于市场调研，创建详细的用户画像
输入：docs/market-research.md（阶段0输出）
执行方式：调用 pm-user-persona skill
传入上下文：
请读取 docs/market-research.md，基于目标用户群体创建用户画像。
要求：
- 创建 2-3 个典型用户画像
- 每个画像包含：基本信息、目标、痛点、使用场景
- 绘制用户旅程地图
输出：docs/user-persona.md
完成标志：用户画像文档已写入，包含至少2个典型用户画像
阶段2：功能优先级
目标：基于用户画像，对功能需求进行优先级排序
输入：
docs/market-research.md（阶段0输出）docs/user-persona.md（阶段1输出）
执行方式：调用 pm-feature-prioritization skill
传入上下文：
请读取 docs/market-research.md 和 docs/user-persona.md，
对以下功能需求进行优先级排序：
[用户提供的功能列表]
使用 RICE 模型评估，输出：
- P0（必须有）功能列表
- P1（重要）功能列表
- P2（可选）功能列表
输出：docs/feature-priority.md
完成标志：功能优先级文档已写入，所有功能已分级
阶段3：产品路线图
目标：基于功能优先级，规划产品迭代路线图
输入：
docs/feature-priority.md（阶段2输出）docs/user-persona.md（阶段1输出）
执行方式：调用 pm-roadmap skill
传入上下文：
请读取 docs/feature-priority.md，规划产品路线图。
要求：
- 将功能分配到 3-4 个版本
- V1.0 只包含 P0 功能（MVP）
- 每个版本设定里程碑和交付时间
- 说明版本间的依赖关系
输出：docs/roadmap.md
完成标志：产品路线图已写入，V1.0 功能范围明确
阶段4：需求澄清
目标：把用户的模糊想法转化为结构化的需求描述
执行方式：通过对话逐步澄清，不一次性抛出所有问题
必须澄清的内容：
1. 产品是什么？解决谁的什么问题？
2. 目标用户是谁？（角色类型、使用场景）
3. 核心功能有哪些？（让用户列举，而不是猜）
4. 涉及哪些端？（Web管理后台 / 用户端 / 移动端）
5. 有没有特殊的业务规则或约束？
输出：docs/requirements.md
# [产品名称] 需求概述
## 产品定位
[一句话描述]
## 目标用户
[用户角色列表]
## 核心功能清单
[功能列表，按模块组织]
## 涉及端
- [ ] Web 管理后台
- [ ] Web 用户端
- [ ] 移动端 H5
## 特殊说明
[业务规则、约束条件]
完成标志：用户确认需求描述准确，且已写入 docs/requirements.md
阶段5：需求说明书
目标：将需求概述扩展为可供研发直接使用的完整说明书
输入：
docs/requirements.md（阶段4输出）docs/roadmap.md（阶段3输出，了解V1.0范围）
执行方式：调用 req-doc skill，传入阶段4的需求描述
关键规范：
- 读取
docs/requirements.md和docs/roadmap.md作为输入上下文 - 只生成 V1.0 版本的功能（根据路线图）
- 每个功能模块创建一个 TaskCreate 任务，逐模块生成
- 生成顺序：项目概述 → 系统功能架构 → 各模块功能详述
输出：docs/spec.md
完成标志：需求说明书覆盖所有 V1.0 功能模块，每个模块包含需求概述 + 操作流程 + 功能设计 + 字段说明
阶段6：前端原型
目标：基于需求说明书生成可运行的前端原型代码
输入：docs/spec.md（阶段二输出）
执行方式：
Step 3.1 — 搭建项目框架
根据产品类型选择对应 skill：
- 管理后台 →
vue-admin-generator（输出完整项目框架） - 移动端 →
mobile-app-generator - 官网 →
website-generator
传入上下文：读取 docs/spec.md 中的系统功能架构章节，提取：
- 菜单结构（一级/二级/三级菜单）
- 主题色要求
- 登录方式
Step 3.2 — 逐页面生成
框架搭建完成后，为每个功能页面创建独立任务：
调用 page-generator，每次传入：
docs/spec.md中对应模块的详细需求- 已有的项目框架结构（路由、组件规范）
每生成一个页面，在对应 TaskCreate 任务中标记 completed。
Step 3.3 — UI 规范检查（可选）
如果用户有特定设计风格要求，调用 ui-ux-pro-max 生成设计规范。
输出：完整可运行的前端项目代码
完成标志：所有页面生成完毕，可通过 npm run dev 启动
阶段7：测试用例
目标：基于需求说明书生成完整的测试用例集
输入：docs/spec.md（阶段5输出）
执行方式：调用 pm-test-cases skill
传入上下文：
请读取 docs/spec.md，为以下功能模块生成测试用例：
[列出所有功能模块名称]
要求：
- 覆盖功能测试、边界测试、异常测试、权限测试
- P0 用例覆盖所有主流程
- 每个必填字段都有为空的测试用例
- 每个有权限控制的功能都有权限越权测试
输出：docs/test-cases.md
完成标志：所有功能模块都有测试用例，P0 冒烟测试集不少于核心流程数量
阶段8：操作手册
目标：基于需求说明书和原型，生成面向用户的操作手册
输入：
docs/spec.md（阶段5输出）src/（阶段6输出，了解实际页面结构）
执行方式：调用 pm-operation-manual skill
默认生成两个版本：
- 用户操作手册（
docs/operation-manual-user.md）：面向终端用户 - 快速入门指南（
docs/quick-start.md）：新用户10分钟上手
如有管理员角色，额外生成管理员手册（docs/operation-manual-admin.md）
传入上下文：
请读取 docs/spec.md，生成用户操作手册。
系统信息：
- 系统名称：[从spec.md提取]
- 用户角色：[从spec.md提取]
- 主要功能模块：[从spec.md提取的功能架构]
要求：
- 操作步骤清晰，每步一个动作
- 界面元素用【】标注
- 关键注意事项用"注意："标注
完成标志：手册覆盖所有核心功能，操作步骤可独立执行
阶段9：发版说明
目标：基于需求说明书和实际交付内容，生成发版说明文档
输入：
docs/spec.md（阶段5输出）docs/roadmap.md（阶段3输出，了解版本规划）src/（阶段6输出，了解实际实现的功能）
执行方式：调用 pm-release-notes skill
传入上下文：
请读取 docs/spec.md 和 docs/roadmap.md，生成 V1.0 版本的发版说明。
版本信息：
- 版本号：V1.0
- 发布日期：[预计发布日期]
- 主要功能：[从 spec.md 提取的 V1.0 功能列表]
要求：
- 面向用户的语言，突出功能价值
- 按功能模块分类说明
- 包含已知问题和后续计划
输出：docs/release-notes.md
完成标志：发版说明清晰描述所有新功能，用户可快速了解版本更新内容
流程控制规则
阶段间传递规范
每个阶段完成后，必须确保输出文件已写入，才能进入下一阶段：
阶段0完成 → docs/market-research.md ✅ → 进入阶段1
阶段1完成 → docs/user-persona.md ✅ → 进入阶段2
阶段2完成 → docs/feature-priority.md ✅ → 进入阶段3
阶段3完成 → docs/roadmap.md ✅ → 进入阶段4
阶段4完成 → docs/requirements.md ✅ → 进入阶段5
阶段5完成 → docs/spec.md ✅ → 进入阶段6/7/8
阶段6完成 → src/ ✅ → 进入阶段8（手册需要了解原型结构）
阶段7完成 → docs/test-cases.md ✅
阶段8完成 → docs/operation-manual*.md ✅ → 进入阶段9
阶段9完成 → docs/release-notes.md ✅
可以并行的阶段
阶段5（说明书）完成后，阶段6/7/8可以并行：
- 测试用例只依赖说明书，不依赖原型代码
- 操作手册主要依赖说明书，可以先生成再补充原型细节
用户确认节点
以下节点必须等用户确认后再进入下一阶段：
- 阶段0结束后：用户确认市场调研结论
- 阶段3结束后：用户确认产品路线图
- 阶段4结束后：用户确认需求描述准确
- 阶段5结束后：用户确认说明书符合预期（可修改）
- 阶段6每个页面生成后：用户确认页面结构正确
进度汇报
每完成一个阶段，输出进度摘要：
✅ 阶段[N] 完成
产出文件：[文件路径]
核心内容：[2-3句话描述产出内容]
下一步：[说明下一阶段将做什么，需要用户确认什么]
---
整体进度：[N]/10 个阶段完成
目录结构规范
流程结束后，项目目录结构如下：
[项目目录]/
├── docs/
│ ├── market-research.md ← 阶段0：市场调研
│ ├── user-persona.md ← 阶段1：用户画像
│ ├── feature-priority.md ← 阶段2：功能优先级
│ ├── roadmap.md ← 阶段3：产品路线图
│ ├── requirements.md ← 阶段4：需求概述
│ ├── spec.md ← 阶段5：需求说明书
│ ├── test-cases.md ← 阶段7：测试用例
│ ├── operation-manual-user.md ← 阶段8：用户手册
│ ├── operation-manual-admin.md ← 阶段8：管理员手册（如有）
│ ├── quick-start.md ← 阶段8：快速入门
│ └── release-notes.md ← 阶段9：发版说明
└── src/ ← 阶段6：前端原型代码
├── views/
├── components/
└── ...
快速恢复（断点续跑）
如果中途中断，再次启动时：
- 检查
docs/目录已有哪些文件 - 根据已有文件判断完成到哪个阶段
- 从未完成的阶段继续，无需重新开始
判断逻辑：
docs/market-research.md 存在 → 阶段0已完成
docs/user-persona.md 存在 → 阶段1已完成
docs/feature-priority.md 存在 → 阶段2已完成
docs/roadmap.md 存在 → 阶段3已完成
docs/requirements.md 存在 → 阶段4已完成
docs/spec.md 存在 → 阶段5已完成
src/ 目录有代码 → 阶段6已完成（或进行中）
docs/test-cases.md 存在 → 阶段7已完成
docs/operation-manual*.md 存在 → 阶段8已完成
docs/release-notes.md 存在 → 阶段9已完成