🚀 需求分析 Agent 核心功能定义

基于 OpenClaw + Claude Code 的端到端研发自动化系统 · 从需求到部署的全流程自动化

📅 版本：1.0 🕐 日期：2026-03-18 🎯 阶段：需求分析 ⚡ AI 驱动

Agent 概述与定位

🎯
核心目标
  • 自动化理解、分析和结构化用户需求
  • 提取可执行的功能点和技术约束
  • 为后续 PRD 设计、技术方案设计提供标准化输入
  • 支持人机协同的需求澄清与确认
🔗
在研发流程中的位置
原始需求 (自然语言)
⬇
需求分析 Agent
结构化提取
⬇
PRD 设计 Agent
⬇
技术方案设计 Agent

核心功能模块

5
核心模块
20+
子功能
90%+
自动化率目标
<20%
人工介入率
1️⃣
需求接收与预处理

多通道需求接入、噪声过滤、术语标准化、智能分段

文本输入 语音转文本 结构化数据
2️⃣
需求理解与语义分析

意图识别、实体抽取、依赖关系分析

功能需求 非功能需求 业务规则
3️⃣
需求结构化提取

用户故事生成、功能点拆解、技术约束提取

MoSCoW 优先级 验收标准
4️⃣
需求质量评估

SMART 原则检验、完整性检查、一致性验证

SMART 完整性 一致性
5️⃣
人机协同模块

需求澄清对话、确认工作流、变更影响分析

澄清对话 变更分析
🔧
SubAgents

需求澄清子 Agent、技术可行性评估子 Agent

专项处理 并行执行

系统架构设计

📥 第 1 层：预处理层
噪声过滤
术语标准化
段落分割
格式统一
🧠 第 2 层：语义分析层
意图分类
实体抽取
关系识别
上下文理解
🏗️ 第 3 层：结构化提取层
用户故事生成
功能点拆解
约束条件提取
优先级判定
✅ 第 4 层：质量评估层
SMART 检验
完整性检查
一致性验证
冲突检测
📤 输出层
SRD 文档
RTM 矩阵
分析报告
交接数据包

需求结构化提取规则

意图分类关键词

意图类型 关键词示例 优先级
功能需求 可以、能够、支持、实现、提供、允许、需要、必须 Must
非功能需求 性能、效率、响应时间、吞吐量、并发、可用、可靠 Should
安全需求 安全、加密、认证、授权、权限、审计、日志 Must
数据需求 存储、数据、字段、表、索引、备份、归档 Should
集成需求 对接、集成、接口、API、SDK、webhook、回调 Could
UI/UX 需求 界面、页面、布局、样式、交互、动画、反馈 Could

MoSCoW 优先级判定规则

🔴 Must have (必须有)
  • 关键词：必须、一定要、核心、基本、必要
  • 缺少则系统无法运行
  • 核心价值无法实现
  • 技术前置依赖
🟡 Should have (应该有)
  • 关键词：应该、重要、需要、最好、优先
  • 重要但不紧急
  • 可以短期延期
  • 显著提升用户体验
🟢 Could have (可以有)
  • 关键词：可以、能够、可选、锦上添花
  • 锦上添花的功能
  • 资源充足时实现
  • 低优先级增强
⚪ Won't have (暂不实现)
  • 关键词：暂不、以后再说、不考虑
  • 本次迭代明确不包含
  • 留待未来版本
  • 已排除的需求

SMART 质量评估体系

S - Specific (具体的)

需求描述是否清晰具体？检查是否存在模糊词汇如"可能"、"大概"、"快速"等。

目标清晰度 ≥90%

M - Measurable (可衡量的)

是否有可量化的指标？检查是否包含数值或可验证条件。

可衡量度 ≥95%

A - Achievable (可实现的)

技术上是否可行？结合技术约束和历史数据评估。

可实现性 ≥85%

R - Relevant (相关的)

是否与业务目标一致？追溯需求到业务价值。

相关性 ≥90%

T - Time-bound (有时限的)

是否有明确的时间要求？检查是否包含时间节点。

时限性 ≥80%

输出产物规范

📄
结构化需求文档 (SRD)
  • 文档 ID 与版本信息
  • 项目基本信息
  • 执行摘要
  • 用户故事列表 (含优先级)
  • 功能需求汇总
  • 非功能需求汇总
  • 技术约束
  • 业务规则
  • 风险与缓解措施
📊
需求追踪矩阵 (RTM)
  • 需求 ID 追踪
  • 用户故事映射
  • 功能点关联
  • 优先级标注
  • 状态跟踪
  • 测试用例关联

JSON 输出示例

{
  "document_id": "REQ-2026-001",
  "version": "1.0",
  "user_stories": [
    {
      "id": "US-001",
      "role": "普通用户",
      "action": "注册账号",
      "business_value": "成为系统用户，使用核心功能",
      "priority": "Must have",
      "acceptance_criteria": [
        "用户可以通过邮箱注册",
        "密码长度至少 8 位",
        "需要邮箱验证"
      ],
      "estimated_effort": "3 story points"
    }
  ],
  "quality_report": {
    "smart_scores": {
      "specific": 0.9,
      "measurable": 1.0,
      "achievable": 0.95,
      "relevant": 0.9,
      "time_bound": 0.8
    }
  }
}

质量标准与度量

需求质量指标

指标名称 计算方法 目标值
需求清晰度 (无模糊表述的需求数 / 总需求数) × 100% ≥ 90%
需求完整性 (字段完整的需求数 / 总需求数) × 100% ≥ 95%
需求一致性 (无冲突的需求数 / 总需求数) × 100% ≥ 98%
需求可追溯性 (有明确来源的需求数 / 总需求数) × 100% 100%
需求可验证性 (有验收标准的需求数 / 总需求数) × 100% 100%

自动化程度指标

≥80%
自动提取率

自动提取的功能点数 / 总功能点数

≥70%
自动澄清率

自动解决的模糊点数 / 总模糊点数

≤20%
人工介入率

需要人工处理的需求数 / 总需求数

与其他 Agent 的接口

原始需求
输入接口
→
需求分析 Agent
核心处理
→
PRD 设计 Agent
输出交接
→
技术方案 Agent
downstream
📥 输入接口
class RequirementInput:
    raw_text: str           # 原始需求文本
    attachments: List       # 附件列表
    metadata: Dict          # 元数据
    context: ProjectContext # 项目上下文
📤 输出接口
class RequirementOutput:
    structured_requirement: SRD
    quality_report: QualityReport
    clarification_log: List
    recommendations: List
    next_agent_handoff: HandoffInfo