Quick PRD Workflow

What This Workflow Does

Orchestrates multiple skills to produce a complete PRD with competitive context. First analyzes competitors (if provided), then generates PRD incorporating those insights. Finally, creates prototype in user-selected format (HTML).

Workflow Architecture

本工作流采用 Plan-and-Execute 模式组织，确保完整的阶段定义、状态追踪和质量门控。

五层对应阶段

Stage ID	名称	对应层	说明
S0	Setup	初始化	创建工作流状态文件
S1	Perception	需求感知	市场研究、用户画像、竞品分析
S2	Strategy	策略规划	产品定位、路线图规划、优先级排序
S3	Design	方案设计	PRD 生成、原型设计
S4	Delivery	交付协调	需求评审、项目计划、发布管理
S5	Validation	价值验证	效果分析、反馈综合、迭代规划

---

Workflow Stages

Stage ID	名称	质量门控	下阶段
S0	Setup	-	S1
S1	Perception	市场研究完成	S2
S2	Strategy	定位完成	S3
S3	Design	PRD 完整	S4
S3	Design	原型验证	S5
S4	Delivery	需求评审	S5

阶段执行顺序：S0 → S1 → S2 → S3 → S4 → S5

---

Stage 0: Setup

目标：初始化工作流状态和上下文目录

活动：

• 创建 context/workflow-state/ 目录用于工作流快照
• 初始化 context/current-workflow.json 当前状态文件

输出：

• context/workflow-state/ 目录
• context/current-workflow.json 空模板

质量门控：

• ✅ 目录结构创建完成
• ✅ 状态模板初始化完成

---

Stage 1: Perception

目标：完成需求感知层的数据收集和分析

Step 1.0: Perception Brainstorming (BEFORE any skill invocation)

1. Analyze user's initial input for the product/feature domain
2. Identify what perception data already exists in context/
3. Gap Analysis: What's missing for a complete perception picture?
   • Market intelligence: market scope, trends, TAM/SAM/SOM
   • Competitive analysis: which competitors, feature focus
   • User research: target users, pain points, personas
4. For each gap, ask user ONE question at a time using AskUserQuestion:
   • "需要分析哪些竞品？" → multi-select
   • "目标用户是谁？" → multiple choice options
   • "有用户研究数据吗？" → yes/no/need to conduct
5. Present a Perception Summary to the user:
   • What we know
   • What we've analyzed (market, competitors, users)
   • What's still unclear
   • Recommended next steps
6. User must approve the Perception Summary before entering skill invocation.

技能调用：

• Step 1.1: 调用 /competitive-analysis
• Step 1.2: 调用 /market-intelligence
• Step 1.3: 调用 /user-research

输出：

• context/competitive-analysis/{feature-name}-{date}.json + .md
• context/market-analysis.json
• context/user-research.json
• context/user-personas.json

质量门控：

• ✅ 竞品分析完成 - 2+ 个竞品功能对比
• ✅ 市场研究完成 - 市场规模、趋势、机会点
• ✅ 用户画像完成 - 2+ 个用户角色定义
• 质量门控通过 - 进入 Strategy 阶段

状态更新：

{
  "workflow_id": "wf-{{timestamp}}",
  "workflow_name": "quick-prd",
  "status": "in_progress",
  "current_layer": "perception",
  "current_skill": "competitive-analysis",
  "current_stage": "S1",
  "completed_stages": ["S0"],
  "mode": "copilot"
  "started_at": "{{ISO_8601}}",
  "updated_at": "{{ISO_8601}}"
}

---

Stage 2: Strategy

目标：完成策略规划层的工作

活动：

1. 产品定位 - product-positioning skill
2. 路线图规划 - roadmap-planning skill
3. 优先级排序 - prioritization skill

技能调用：

• Step 2.1: 调用 /product-positioning
• Step 2.2: 调用 /roadmap-planning
• Step 2.3: 调用 /prioritization

输出：

• context/positioning.md
• context/roadmap.md
• context/prioritization.json

质量门控：

• ✅ 产品定位完成 - 价值主张清晰、差异化策略明确
• ✅ 路线图完成 - 12 个月里程碑规划
• ✅ 优先级排序完成 - RICE/MoSCoW 框架应用

Stage 2.5: Strategy Confirmation Gate (HARD GATE)

在阶段 2 完成后、进入阶段 3 前，必须执行此门控。

1. 向用户展示完整的策略层产出：

   • Positioning Statement（来自 context/positioning.md）
   • Key messages 和 value proposition
   • Prioritization 结果（来自 context/prioritization.json）— 前 N 项及 RICE 分数
   • Roadmap 亮点（来自 context/roadmap.md）— 关键里程碑

2. 使用 AskUserQuestion 让用户确认：

   Option	Description
   ✅ 确认，进入 Design 阶段	进入 Stage 3
   ✏️ 需要调整定位/优先级	留在 Stage 2，修订相关 skill
   ⏸️ 回到 Perception 补充信息	回到 Stage 1
   📋 查看完整策略文档	先读全文档再决定

3. 仅当用户明确选择"✅ 确认，进入 Design 阶段"时，才能进入 Stage 3。

4. 如果用户选择修订，回到相关 skill 进行 refinement。

5. 将确认记录到 context/current-workflow.json。

• 质量门控通过 - 进入 Design 阶段

状态更新：

{
  "completed_stages": ["S0", "S1"],
  "current_layer": "strategy",
  "current_skill": "prioritization",
  "current_stage": "S2",
  "status": "in_progress",
  "mode": "copilot",
  "updated_at": "{{ISO_8601}}"
}

---

Stage 3: Design

目标：完成方案设计层的 PRD 生成和原型创建

活动：

1. PRD 生成 - prd-gen skill
2. 原型设计 - prototype-design skill（HTML）

技能调用：

• Step 3.1: 调用 /prd-gen

输出：

• context/prd/{feature-name}-{date}-v{version}.md
• context/prototypes/{feature-name}.html（如选择）

原型格式选择：

在 PRD 生成后，询问用户选择原型输出格式：

Option	Description	输出位置
HTML 原型	可在浏览器直接预览、演示交互	context/prototypes/{name}.html

质量门控：

• ✅ PRD 完整（9 章节 + 行业基准）

• 质量门控通过 - 进入 Delivery 阶段

状态更新：

{
  "completed_stages": ["S0", "S1", "S2"],
  "current_layer": "design",
  "current_skill": "prototype-design",
  "current_stage": "S3",
  "status": "in_progress",
  "mode": "copilot",
  "updated_at": "{{ISO_8601}}"
}

---

Stage 4: Delivery

目标：完成交付协调层的工作

活动：

1. 需求评审 - requirement-review skill
2. 项目计划 - project-coordination skill
3. 发布管理 - release-management skill

技能调用：

• Step 4.1: 调用 /requirement-review
• Step 4.2: 调用 /project-coordination
• Step 4.3: 调用 /release-management

输出：

• context/review-notes/[feature]-review.md
• context/project-plan.md
• context/release-plan.md

质量门控：

• ✅ 需求评审完成 - 干系人对齐、签字确认
• ✅ 项目计划完成 - 任务分配、时间线确认
• ✅ 发布准备完成 - 代码冻结、发布包就绪
• 质量门控通过 - 进入 Validation 阶段

状态更新：

{
  "completed_stages": ["S0", "S1", "S2", "S3"],
  "current_layer": "delivery",
  "current_skill": "release-management",
  "current_stage": "S4",
  "status": "in_progress",
  "mode": "copilot",
  "updated_at": "{{ISO_8601}}"
}

---

Stage 5: Validation

目标：完成价值验证层的数据收集和分析

活动：

1. 效果分析 - impact-analysis skill
2. 反馈综合 - feedback-synthesis skill
3. 迭代规划 - iteration-planning skill

技能调用：

• Step 5.1: 调用 /impact-analysis
• Step 5.2: 调用 /feedback-synthesis
• Step 5.3: 调用 /iteration-planning

输出：

• context/impact-analysis/{feature-name}-{date}.json
• context/feedback-synthesis/{feature-name}-{date}.json
• context/iteration-plan.json

质量门控：

• ✅ 效果分析完成 - 目标达成度分析、关键指标收集
• ✅ 反馈综合完成 - 用户反馈收集、主题分析、改进建议
• ✅ 迭代规划完成 - 下一轮迭代计划制定
• 工作流完成 - 全部 5 个阶段完成

状态更新：

{
  "completed_stages": ["S0", "S1", "S2", "S3", "S4"],
  "current_layer": "validation",
  "current_skill": "iteration-planning",
  "current_stage": "S5",
  "status": "completed",
  "mode": "copilot",
  "updated_at": "{{ISO_8601}}"
}

---

工作流状态管理

状态字段

{
  "workflow_id": "唯一的工作流ID",
  "workflow_name": "工作流名称",
  "status": "in_progress | completed | blocked",
  "current_layer": "perception | strategy | design | delivery | validation",
  "current_skill": "当前执行的 Skill",
  "current_stage": "当前阶段 (S0-S5)",
  "completed_stages": "已完成的阶段列表",
  "mode": "协作模式 (autopilot | copilot | manual)",
  "started_at": "ISO 8601 时间戳",
  "updated_at": "最后更新时间 (ISO 8601)"
}

---

协作模式 (Collaboration Modes)

模式	描述	适用场景
autopilot	AI 自动执行	快速验证、演示、数据监控
copilot	AI 建议、人工确认	PRD 生成、需求评审、项目计划
manual	人工主导、AI 辅助	战略决策、创意发散、危机处理

---

质量门控 (Quality Gates)

每个阶段完成后必须满足对应的质量标准才能进入下一阶段：

Perception 层质量门控

perception_gates:
  S1_to_S2:
    - market_research_complete:
        - 市场研究完成
        - 竞品列表确定
        - 关键玩家识别
    - user_research_complete:
        - 用户访谈完成
        - 用户画像创建
        - 痛点识别
    - competitive_analysis_complete:
        - 竞品分析完成
        - 功能对比矩阵
        - 差异化识别

Strategy 层质量门控

strategy_gates:
  S2_to_S3:
    - positioning_complete:
        - 定位声明创建
        - 价值主张明确
        - 差异化策略制定
    - roadmap_complete:
        - 里程碑规划完成
        - 时间线设定
    - prioritization_complete:
        - RICE 评分完成
        - 优先级列表确定

Design 层质量门控

design_gates:
  S3_to_S4:
    - prd_complete:
        - PRD 完整（9 章）
        - 用户故事映射
        - 验收标准定义
    - prototype_validated:
        - 原型已创建
        - 交互功能验证
        - 设计一致性检查

Delivery 层质量门控

delivery_gates:
  S4_to_S5:
    - requirement_review_complete:
        - 需求评审完成
        - 干系人对齐
        - 签字确认
    - project_plan_complete:
        - 任务分配完成
        - 时间线确认
    - release_ready:
        - 代码冻结
        - 发布包就绪

Validation 层质量门控

validation_gates:
  S5_complete:
    - impact_analysis_complete:
        - 目标达成度分析
        - 关键指标收集
    - feedback_synthesis_complete:
        - 反馈收集完成
        - 主题分析完成
    - iteration_planning_complete:
        - 下一轮迭代计划制定

---

上下文集成

读取：

• context/current-workflow.json - 当前工作流状态
• context/prd/*.md - PRD 文档
• context/competitive-analysis/*.json - 竞品分析数据
• context/prototypes/*.html - HTML 原型

写入：

• context/workflow-state/{{workflow_id}}.json - 工作流快照（按日期）
• context/review-notes/*.md - 评审记录
• context/project-plan/*.md - 项目计划
• context/release-plan/*.md - 发布计划
• context/impact-analysis/*.json - 效果分析
• context/feedback-synthesis/*.json - 反馈综合
• context/iteration-plan.json - 迭代计划

---

示例：工作流执行轨迹

{
  "workflow_id": "wf-20260317-001",
  "workflow_name": "quick-prd",
  "status": "completed",
  "completed_stages": ["S0", "S1", "S2", "S3", "S4", "S5"],
  "execution_trace": [
    {
      "stage": "S1",
      "skill": "competitive-analysis",
      "started_at": "2026-03-17T10:00:00Z",
      "completed_at": "2026-03-17T10:02:00Z",
      "outputs": ["competitor-list.json"]
    },
    {
      "stage": "S2",
      "skill": "prioritization",
      "started_at": "2026-03-17T10:03:00Z",
      "completed_at": "2026-03-17T10:05:00Z",
      "outputs": ["prioritization.json"]
    },
    {
      "stage": "S3",
      "skill": "prd-gen",
      "started_at": "2026-03-17T10:06:00Z",
      "completed_at": "2026-03-17T10:08:00Z",
      "outputs": ["prd-final.md", "prototype.html"]
    },
    {
      "stage": "S4",
      "skill": "requirement-review",
      "started_at": "2026-03-17T10:10:00Z",
      "completed_at": "2026-03-17T10:15:00Z",
      "outputs": ["review-notes.md", "project-plan.md"]
    },
    {
      "stage": "S5",
      "skill": "iteration-planning",
      "started_at": "2026-03-17T10:18:00Z",
      "completed_at": "2026-03-17T10:20:00Z",
      "outputs": ["iteration-plan.json"]
    }
  ],
  "mode": "copilot",
  "started_at": "2026-03-17T10:00:00Z",
  "updated_at": "2026-03-17T10:20:00Z"
}