🚀 需求分析与 PRD 生成模块使用手册

第一章：系统概述与架构 核心模块

1.1 系统定位

本模块是OpenClaw + Claude Code 端到端研发自动化系统的起始环节，负责将原始需求转化为标准化的产品需求文档（PRD）。 系统通过 AI Agent 集群实现需求的智能分析、拆解、验证和文档化，支持从模糊想法到完整 PRD 的全自动转化。

1.2 系统架构图

1.3 核心技术栈

第二章：需求分析模块详解 AI 增强

2.1 需求输入方式

系统支持多种需求输入形式，满足不同场景的使用需求：

2.1.1 自然语言描述

# 示例：通过命令行直接输入需求
claude --mode prd-analyzer << 'EOF'
我需要开发一个在线商城系统，主要功能包括：
1. 用户注册登录（支持手机号、微信、邮箱）
2. 商品展示与搜索（支持分类筛选、关键词搜索）
3. 购物车功能（添加、删除、修改数量）
4. 订单管理（下单、支付、物流跟踪）
5. 后台管理系统（商品上架、订单处理、数据统计）

目标用户：中小型电商企业
预期并发：日均 PV 10 万，峰值 QPS 500
部署环境：阿里云 Kubernetes 集群
EOF

2.1.2 语音转文字输入

# 启用语音识别模式
openclaw agent start --input-mode voice --language zh-CN

# 系统会自动调用语音识别 API 并转换为文本进行分析
# 支持方言识别：普通话、粤语、四川话等

2.1.3 文档导入解析

# 支持格式：Word/PDF/Markdown/TXT
claude --import requirement_draft.docx --analyze

# 系统会自动提取关键信息并结构化
# 识别率：中文 98%，英文 99%，混合 97%

2.2 需求智能分析流程

2.3 需求质量检查清单

系统会自动执行以下检查项，确保需求质量：

第三章：PRD 自动生成流程 自动化核心

3.1 PRD 标准结构模板

系统生成的 PRD 遵循以下标准化结构，确保文档的专业性和完整性：

# PRD 文档结构 v2026.3
## 1. 文档概览
   1.1 版本历史
   1.2 修订记录
   1.3 参与人员

## 2. 产品愿景
   2.1 产品定位
   2.2 目标用户
   2.3 核心价值主张
   2.4 成功指标 (OKR/KPI)

## 3. 需求范围
   3.1 In-Scope（包含功能）
   3.2 Out-of-Scope（排除功能）
   3.3 未来规划 (Roadmap)

## 4. 功能需求
   4.1 功能清单
   4.2 功能详细描述
       - 用户故事 (User Story)
       - 验收标准 (Acceptance Criteria)
       - 业务规则
       - 界面原型链接
   4.3 功能优先级 (MoSCoW)

## 5. 非功能需求
   5.1 性能要求 (QPS/RT/并发数)
   5.2 安全要求 (认证/授权/加密)
   5.3 可用性要求 (SLA/容灾)
   5.4 兼容性要求 (浏览器/设备/OS)

## 6. 数据需求
   6.1 数据模型
   6.2 数据流转图
   6.3 数据埋点设计

## 7. 接口需求
   7.1 内部接口
   7.2 外部接口 (第三方服务)

## 8. 运营需求
   8.1 监控告警
   8.2 日志规范
   8.3 数据分析

## 9. 附录
   9.1 术语表
   9.2 参考资料
   9.3 待决策事项

3.2 一键生成命令

# 基础生成命令
claude --generate-prd \
  --input "requirements.json" \
  --output "prd_v1.0.md" \
  --template "standard" \
  --industry "ecommerce"

# 带自定义配置的生成
openclaw agent run prd-generator \
  --config prd_config.yaml \
  --context ./context_docs/ \
  --reviewers "pm_lead,tech_lead,qa_lead" \
  --auto-commit true

# 增量更新模式（基于已有 PRD 进行迭代）
claude --update-prd \
  --base "prd_v1.0.md" \
  --changes "change_request.json" \
  --output "prd_v1.1.md"

3.3 PRD 质量评分系统

生成的 PRD 会自动获得质量评分，帮助团队判断文档成熟度：

第四章：人机协同工作模式 智能协作

4.1 协同评审流程

4.2 在线评审工具集成

# 飞书集成配置
openclaw integrate feishu \
  --app-id "cli_a1b2c3d4e5f6" \
  --app-secret "xxx" \
  --webhook-url "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"

# 钉钉集成配置
openclaw integrate dingtalk \
  --agent-id "agent_xxx" \
  --app-key "xxx" \
  --app-secret "xxx"

# 启动评审会议（自动创建会议链接并邀请相关人员）
claude --start-review \
  --doc "prd_v1.0.md" \
  --platform feishu \
  --participants "pm@company.com,tech@company.com,qa@company.com" \
  --deadline "2026-03-15 18:00"

4.3 评论与批注处理

系统支持智能处理评审意见，自动分类并生成修改建议：

4.4 版本管理与追溯

# 查看 PRD 版本历史
claude --version-history prd_v*.md

# 输出版本对比报告
claude --diff prd_v1.0.md prd_v1.1.md --output diff_report.html

# 回滚到指定版本
claude --rollback prd_v1.2.md --to-version 1.0

# 需求追溯矩阵（需求 ID -> 测试用例 -> 代码提交）
openclaw trace generate \
  --requirement-id "REQ-2026-001" \
  --output traceability_matrix.xlsx

第五章：各角色 Agent 配置指南 角色定制

5.1 研发角色 Agent 矩阵

5.2 Agent 配置文件示例

# config/agents/pm_agent.yaml
agent:
  name: "Product Manager Agent"
  role: "product_manager"
  model: "claude-sonnet-4.6"
  temperature: 0.7
  max_tokens: 8192
  
  capabilities:
    - requirement_analysis
    - user_story_generation
    - acceptance_criteria_definition
    - priority_assignment
    - roadmap_planning
  
  knowledge_base:
    - industry_standards/ecommerce
    - company_templates/prd
    - historical_projects/2024-2026
  
  prompts:
    system: |
      你是一位资深产品经理，擅长将模糊需求转化为清晰的 PRD 文档。
      请遵循以下原则：
      1. 用户价值优先
      2. MVP 思维，聚焦核心功能
      3. 量化指标，避免模糊描述
      4. 考虑边界情况和异常流程
  
  review_rules:
    - check_ambiguity: true
    - enforce_quantifiable_metrics: true
    - validate_user_journey: true
    - suggest_analytics_events: true

5.3 多 Agent 协同配置

# config/multi_agent_collab.yaml
collaboration:
  workflow: "sequential_with_feedback"
  
  agents:
    - id: "pm_agent"
      stage: 1
      tasks: ["initial_prd_draft"]
      output_to: ["tech_lead_agent", "qa_agent"]
    
    - id: "tech_lead_agent"
      stage: 2
      tasks: ["feasibility_review", "architecture_suggestion"]
      dependencies: ["pm_agent"]
      output_to: ["backend_agent", "frontend_agent"]
    
    - id: "qa_agent"
      stage: 2
      tasks: ["testability_review", "test_case_outline"]
      dependencies: ["pm_agent"]
      output_to: ["pm_agent"]
    
    - id: "security_agent"
      stage: 3
      tasks: ["security_audit", "compliance_check"]
      dependencies: ["tech_lead_agent"]
      output_to: ["pm_agent"]
  
  conflict_resolution:
    strategy: "human_in_the_loop"
    escalation_threshold: 2  # 2 次自动协商失败后升级人工
    mediator: "project_owner"
  
  communication:
    channel: "feishu_bot"
    notification_level: "critical_only"
    daily_digest: true

第六章：实战案例演示 完整示例

6.1 案例背景：在线教育系统需求

# 原始需求输入（自然语言）
claude --new-project "online_education_platform" << 'EOF'
我们要做一个在线教育平台，类似网易云课堂。
主要功能：
- 老师可以上传视频课程
- 学生可以购买课程并观看
- 需要有支付功能
- 希望有学习进度跟踪
- 后台要能看销售数据

预算：首期 50 万，3 个月上线
团队：3 后端 +2 前端 +1 测试 +1 产品
技术栈倾向：Java Spring Cloud + Vue
EOF

6.2 AI 分析输出示例

# 系统自动生成的需求分析报告
========================================
需求分析报告 v1.0
生成时间：2026-03-13 22:55:00
========================================

【识别到的核心功能模块】
1. 用户系统（学员/讲师/管理员）
2. 课程管理系统
3. 视频点播系统
4. 支付系统
5. 学习进度追踪
6. 数据看板

【需求完整性评分】78/100
⚠️ 缺失项提醒：
- 未明确视频存储方案（自建/第三方 CDN）
- 未说明支付方式（微信/支付宝/银联）
- 缺少版权保护机制描述
- 未提及移动端需求（APP/小程序）

【技术可行性评估】8.5/10
✅ 技术栈匹配度高
⚠️ 风险提示：
- 视频转码需要额外基础设施投入
- 高并发场景下的 CDN 成本预估

【建议优先级排序】
P0（Must Have）: 用户系统、课程上传、视频播放、支付
P1（Should Have）: 学习进度、基础数据看板
P2（Could Have）: 高级数据分析、营销工具
P3（Won't Have）: 直播功能、社交功能

6.3 生成的 PRD 节选

# PRD 片段：课程播放功能
## 4.2.3 课程播放功能

### 用户故事
作为学员，我希望能够流畅地观看已购买的课程视频，
以便完成学习任务并掌握知识。

### 功能描述
1. 支持 1080P/720P/480P 多清晰度切换
2. 支持 0.5x-2.0x 播放速度调节
3. 自动记录播放进度，支持断点续播
4. 支持全屏/小窗模式切换
5. 防录屏水印（动态显示学员 ID）

### 验收标准
| 编号 | 验收项 | 通过标准 |
|------|--------|----------|
| AC-1 | 首屏加载时间 | ≤ 2 秒（4G 网络） |
| AC-2 | 卡顿率 | < 3%（100 次播放） |
| AC-3 | 进度记录精度 | 误差 ≤ 5 秒 |
| AC-4 | 多端同步 | 进度同步延迟 ≤ 10 秒 |
| AC-5 | 水印可见性 | 每 30 秒刷新一次动态水印 |

### 业务规则
- 未购买课程仅允许试看前 5 分钟
- VIP 会员可享受 4K 清晰度
- 单账号最多同时 3 个设备在线

### 数据埋点
- video_play_start: 播放开始
- video_progress_update: 进度更新（每 30 秒）
- video_quality_change: 清晰度切换
- video_complete: 播放完成

6.4 完整执行命令序列

#!/bin/bash
# 完整自动化流程脚本

# Step 1: 初始化项目
openclaw project init "online_edu_platform" \
  --template "saas_platform" \
  --industry "education"

# Step 2: 需求分析
claude --analyze-requirements \
  --input "raw_requirements.txt" \
  --output "analysis_report.json" \
  --include-feasibility-check

# Step 3: 生成 PRD 初稿
claude --generate-prd \
  --analysis "analysis_report.json" \
  --output "prd_draft_v1.md" \
  --template "education_saas"

# Step 4: 启动多方评审
openclaw review start \
  --doc "prd_draft_v1.md" \
  --reviewers "pm_lead,tech_architect,qa_lead,security_expert" \
  --deadline "2026-03-16 18:00" \
  --platform "feishu"

# Step 5: 收集评审意见并自动修订
claude --incorporate-feedback \
  --source "review_comments.json" \
  --base "prd_draft_v1.md" \
  --output "prd_v1_final.md"

# Step 6: 质量评分与发布
openclaw quality-score "prd_v1_final.md"
openclaw publish "prd_v1_final.md" --version "1.0.0"

echo "✅ PRD 生成流程完成！文档已发布到知识库"

第七章：常见问题与最佳实践 经验总结

7.1 FAQ 常见问题

7.2 最佳实践建议

7.3 性能优化建议

# 大规模需求处理优化配置
# config/performance_optimization.yaml

performance:
  # 并行处理配置
  parallel_processing:
    enabled: true
    max_concurrent_agents: 5
    batch_size: 10
  
  # 缓存策略
  caching:
    enable_prompt_cache: true
    cache_ttl_hours: 24
    redis_host: "localhost:6379"
  
  # 流式输出（降低首屏等待时间）
  streaming:
    enabled: true
    chunk_size_tokens: 100
  
  # 本地模型加速（可选）
  local_acceleration:
    enabled: false  # 启用本地小模型预处理
    model: "qwen-7b-chat"
    tasks: ["outline_generation", "format_check"]

# 预计性能提升：
# - 首屏响应时间：5s → 1.5s
# - 完整 PRD 生成：10min → 3min
# - 并发处理能力：1 → 5 个项目

附录：模板与资源下载 持续更新

A.1 标准模板下载

A.2 检查清单（Checklist）

# PRD 发布前检查清单
# 使用方法：claude --run-checklist prd_release_checklist

checklist:
  name: "PRD Release Checklist"
  version: "2026.3"
  
  items:
    - id: "CHK-001"
      category: "完整性"
      question: "所有必需章节是否已完成？"
      required: true
      
    - id: "CHK-002"
      category: "完整性"
      question: "每个功能点是否有对应的验收标准？"
      required: true
      
    - id: "CHK-003"
      category: "清晰度"
      question: "是否存在模糊词汇（可能/大概/尽量）？"
      required: true
      
    - id: "CHK-004"
      category: "可测试性"
      question: "所有验收标准是否可量化验证？"
      required: true
      
    - id: "CHK-005"
      category: "一致性"
      question: "术语使用是否全文统一？"
      required: true
      
    - id: "CHK-006"
      category: "技术可行性"
      question: "技术方案是否经过架构师评审？"
      required: true
      
    - id: "CHK-007"
      category: "风险评估"
      question: "是否识别了主要技术风险并有应对方案？"
      required: false
      
    - id: "CHK-008"
      category: "合规性"
      question: "是否符合数据隐私法规要求？"
      required: true
      
    - id: "CHK-009"
      category: "干系人确认"
      question: "所有关键干系人是否已完成评审签字？"
      required: true
      
    - id: "CHK-010"
      category: "版本管理"
      question: "版本号是否正确递增且有变更说明？"
      required: true
  
  pass_threshold: 100%  # 所有 Required 项必须通过

A.3 快捷命令速查表

# ============================================
# 需求分析与 PRD 生成模块 - 快捷命令速查表
# ============================================

# 【需求分析】
claude --analyze "需求描述.txt"              # 快速分析需求
claude --analyze --deep                      # 深度分析（含竞品调研）
claude --analyze --export json               # 导出 JSON 格式分析报告

# 【PRD 生成】
claude --generate-prd --input analysis.json  # 基于分析报告生成 PRD
claude --generate-prd --quick                # 快速生成（简化版）
claude --generate-prd --full                 # 完整版（含所有附录）

# 【评审协作】
claude --start-review doc.md                 # 启动评审流程
claude --collect-feedback                    # 收集评审意见
claude --apply-feedback doc.md               # 应用评审意见修订

# 【质量管理】
claude --quality-score doc.md                # 质量评分
claude --run-checklist                       # 执行检查清单
claude --validate doc.md                     # 格式与规范验证

# 【版本管理】
claude --version-history doc.md              # 查看版本历史
claude --diff v1.0 v1.1                      # 版本对比
claude --rollback doc.md --to 1.0            # 版本回滚

# 【模板管理】
claude --list-templates                      # 列出可用模板
claude --download-template template-name     # 下载模板
claude --upload-template custom.md           # 上传自定义模板

# 【Agent 配置】
openclaw agent list                          # 列出已配置 Agent
openclaw agent enable pm_agent               # 启用指定 Agent
openclaw agent config pm_agent --edit        # 编辑 Agent 配置

# 【集成命令】
openclaw integrate feishu                    # 飞书集成
openclaw integrate dingtalk                  # 钉钉集成
openclaw integrate jenkins                   # Jenkins CI 集成
openclaw integrate gitlab                    # GitLab 集成

A.4 学习资源

• 官方文档：https://openclaw.ai/docs/prd-module
• 视频教程：https://openclaw.ai/tutorials/prd-generation
• 案例库：https://github.com/openclaw/prd-examples
• 社区论坛：https://community.openclaw.ai
• 月度 Webinar：每月最后一个周五晚 8 点（腾讯会议）