需求分析与 PRD 生成模块使用手册 - 基于 OpenClaw + Claude Code 的端到端研发自动化系统

📋 1. 模块概述

ℹ️

模块定位：需求分析与 PRD 生成模块是端到端研发自动化系统的起始环节，负责将原始需求转化为结构化的产品需求文档（PRD）。

1.1 核心功能

📥 需求采集

→

🔍 需求分析

→

📄 PRD 生成

支持输入形式：

文字描述 - 直接输入需求文本
语音转文字 - 会议录音自动转写
文档上传 - Word/PDF/Excel 格式
会议纪要 - 结构化会议记录
竞品信息 - 竞品分析报告

输出产物：

产物名称	格式	说明
requirements_analysis.json	JSON	结构化需求分析数据
user_stories.md	Markdown	用户故事列表
acceptance_criteria.md	Markdown	验收标准详细定义
PRD_v1.0.md	Markdown	完整产品需求文档

1.2 系统架构

🎯

OpenClaw 编排层

任务调度与状态管理

任务拆解 Agent 协作人机协同

🤖

Agent 执行层

需求分析与 PRD 设计

需求分析师产品设计师

💡

Claude Code 引擎

智能编程与文档生成

NLP 理解逻辑推理知识检索

🔧

MCP 工具层

外部工具集成

文件读写 Web 搜索图表生成

🚀 2. 快速开始

Step 1

环境准备

确保系统满足最低要求并安装必要依赖

# 系统要求
- OS: Ubuntu 20.04+ / macOS 12.0+ / Windows 11 WSL2
- CPU: 4 cores
- Memory: 8GB RAM
- Python: 3.10+

Step 2

安装依赖

# 克隆项目仓库
git clone https://github.com/your-org/research-automation-system.git
cd research-automation-system

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

Step 3

配置环境变量

# 复制配置文件
cp .env.example .env

# 编辑.env 文件，填入 API Key
CLAUDE_API_KEY=your_key_here
OPENCLAW_CONFIG_PATH=./config/openclaw.yaml

Step 4

运行第一个任务

# 启动需求分析任务
python -m modules.requirement_analyzer \
  --input "requirements/input_001.txt" \
  --output "projects/project_001/requirements" \
  --mode interactive

✅

验证安装：运行 python -m modules.requirement_analyzer --version 查看版本号确认安装成功。

🎯 3. 需求分析 Agent 使用指南

📊

Requirement Analyst Agent

将模糊需求转化为结构化规格说明

NLP 理解需求提取歧义消除优先级排序依赖识别

3.1 输入规范

格式	说明	示例
纯文本	直接文字描述	"需要一个用户登录功能"
Markdown	结构化文档	# 需求描述\n## 功能列表
Word 文档	.docx 文件	产品需求文档.docx
PDF	PDF 文档	需求规格说明书.pdf

3.2 推荐输入模板

📝 点击展开需求描述模板 ▼

# 需求描述模板

## 1. 项目背景
[描述项目的业务背景、目标用户、解决的问题]

## 2. 目标与范围
### 2.1 项目目标
[量化指标，如：提升转化率 20%]

### 2.2 功能范围
[包含的功能]

### 2.3 不在范围内
[明确排除的内容]

## 3. 用户群体
[目标用户画像]

## 4. 功能需求
### 4.1 功能 1
- 描述
- 优先级 (P0/P1/P2)
- 验收标准

## 5. 非功能需求
- 性能要求
- 安全要求
- 兼容性要求

## 6. 约束条件
- 时间约束
- 技术约束
- 资源约束

3.3 处理流程

Step 1
需求预处理

→

Step 2
需求提取

→

Step 3
需求分析

→

Step 4
需求结构化

→

Step 5
输出生成

3.4 输出详解

{
  "metadata": {
    "project_id": "project_001",
    "version": "1.0",
    "created_at": "2026-03-18T10:16:00Z"
  },
  "summary": {
    "total_requirements": 15,
    "functional_requirements": 12,
    "non_functional_requirements": 3
  },
  "requirements": [
    {
      "id": "REQ-001",
      "type": "functional",
      "title": "用户注册",
      "description": "用户可以通过邮箱或手机号注册账号",
      "priority": "P0",
      "user_story": "As a 新用户，I want 通过邮箱或手机号注册账号...",
      "acceptance_criteria": [...]
    }
  ]
}

# 用户故事列表

## 史诗：用户账户管理

### US-001: 用户注册
**作为** 新用户  
**我想要** 通过邮箱或手机号注册账号  
**以便于** 我可以使用系统服务  

**验收标准:**
- [ ] Given 用户未注册，When 填写有效邮箱和密码...
- [ ] Given 用户未注册，When 填写有效手机号...

# 验收标准详细定义

### AC-001: 邮箱注册成功场景
```gherkin
Feature: 用户注册
  Scenario: 通过邮箱成功注册
    Given 用户未注册且访问注册页面
    When 用户填写有效的邮箱地址
    And 用户填写符合要求的密码
    Then 系统创建新用户账号
    And 系统向该邮箱发送验证邮件
```

📄 4. PRD 设计 Agent 使用指南

✏️

Product Designer Agent

基于需求分析撰写完整 PRD 文档

PRD 写作用户流程设计原型描述业务规则定义

4.1 PRD 文档结构

📋 点击展开/收起标准 PRD 模板 ▼

# 产品需求文档 (PRD)

## 文档信息
| 项目 | 内容 |
|------|------|
| 产品名称 | [产品名称] |
| 版本号 | v1.0 |
| 创建日期 | 2026-03-18 |
| 状态 | 草稿/评审中/已批准 |

## 1. 概述
### 1.1 产品愿景
### 1.2 目标用户
### 1.3 核心价值
### 1.4 成功指标

## 2. 功能需求
### 2.1 功能模块总览
### 2.2 功能详细说明

## 3. 非功能需求
### 3.1 性能要求
### 3.2 安全要求
### 3.3 可用性要求

## 4. 数据需求
### 4.1 数据模型
### 4.2 数据统计

## 5. 接口需求
### 5.1 内部接口
### 5.2 外部接口

## 6. 发布计划
### 6.1 MVP 范围
### 6.2 迭代规划

## 7. 风险与依赖

## 8. 附录

4.2 用户流程图示例

graph TD
    A[用户进入商城] --> B{是否登录}
    B -->|未登录 | C[显示登录弹窗]
    B -->|已登录 | D[显示个性化首页]
    D --> E[浏览商品]
    E --> F{是否搜索}
    F -->|是 | G[输入关键词搜索]
    F -->|否 | H[浏览分类/推荐]
    G --> I[查看搜索结果]
    H --> I
    I --> J{是否查看详情}
    J -->|是 | K[进入商品详情页]
    K --> L{是否加入购物车}
    L -->|是 | M[添加到购物车]
    L -->|否 | N{是否收藏}

🤝 5. 人机协同审核流程

ℹ️

审核点设置：系统在关键环节设置人机协同审核点，确保 AI 生成内容的质量和准确性。

5.1 审核工作流

创建审核任务

→

审核人审核

→

提出修改意见

→

AI 修改

→

重新提交

→

审核通过

5.2 审核清单

所有必需字段已填写（完整性）
用户故事覆盖全部需求（完整性）
验收标准完整定义（完整性）
无歧义表述（清晰度）
术语使用一致（清晰度）
需求间无冲突（一致性）
所有需求有验收标准（可测试性）
技术可实现（可行性）

产品愿景清晰（战略对齐）
目标用户明确（战略对齐）
功能模块完整（功能完整性）
业务流程闭环（功能完整性）
异常流程覆盖（功能完整性）
技术方案可行（技术可行性）
性能要求合理（技术可行性）
用户流程顺畅（用户体验）
后台管理完善（运营支持）

✨ 6. 最佳实践

6.1 需求编写 DO's & DON'Ts

✅ DO's (推荐做法)

使用用户故事格式：As a... I want... So that...
验收标准用 Given-When-Then 格式
需求原子化，独立可测试
优先级明确：P0/P1/P2
量化指标：响应时间 < 500ms

❌ DON'Ts (避免做法)

❌ 模糊表述："快速"响应 → 应量化
❌ 复合需求：拆分为独立需求
❌ 技术实现细节：由技术团队决定
❌ 主观形容词："美观" → 遵循设计规范

6.2 人机协作建议

AI 擅长的工作	人类擅长的工作
📊 大量信息的结构化整理	🎯 战略方向的判断
📝 标准化文档的撰写	💡 创新想法的提出
🔍 模式和异常的识别	🤝 利益相关者的协调
📈 数据和指标的生成	🎨 审美和体验的把握
🔄 流程图的自动生成	⚖️ 复杂权衡的决策

❓ 7. 常见问题

Q1: 安装时遇到依赖冲突怎么办？ ▼

建议使用虚拟环境隔离依赖：

# 使用 conda 创建独立环境
conda create -n research_auto python=3.10
conda activate research_auto
pip install -r requirements.txt

# 或使用 venv
python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

Q2: Claude API 调用失败？ ▼

检查以下几点：

API Key 是否正确配置
网络连接是否正常
API 配额是否用完
防火墙是否阻止

# 测试 API 连接
curl -H "Authorization: Bearer $CLAUDE_API_KEY" \
     https://api.anthropic.com/v1/models

Q3: AI 生成的需求不够具体怎么办？ ▼

采取以下措施：

在输入中提供更多上下文
使用更具体的 Prompt
添加示例参考
设置质量门禁

Q4: 如何批量处理多个需求文档？ ▼

使用批量处理模式：

python -m modules.requirement_analyzer \
  --input-dir requirements/batch_input/ \
  --output-dir projects/batch_output/ \
  --parallel 5  # 并行处理 5 个任务

📎 8. 附录：模板与示例

8.1 需求输入模板下载

📝 需求描述模板

标准化的需求输入格式，包含项目背景、目标用户、功能需求等完整结构。

📋 PRD 评审检查表

完整的 PRD 评审清单，包含战略对齐、功能完整性、技术可行性等维度。

📊 用户故事卡片

标准的用户故事格式模板，包含验收标准和任务分解。

8.2 示例项目

projects/online_mall_demo/
├── requirements/
│   └── v1.0/
│       ├── requirements_analysis.json
│       ├── user_stories.md
│       ├── acceptance_criteria.md
│       └── clarification_log.md
├── prd/
│   └── v1.0/
│       ├── PRD_v1.0.md
│       ├── user_flow_diagrams.md
│       ├── wireframes_description.md
│       └── review_feedback.md
└── metadata.yaml