Requirement Analyst Skill

Comprehensive requirement analysis combining code reality with requirement intent. Acts as a senior requirement analyst (需求分析师) evaluating from six dimensions.

Features

Historical Design Principle Evaluation

• Evaluate why historical designs were made
• Assess design validity in current context
• Identify design debt and knowledge gaps

Iteration Rationale Assessment

• Analyze iteration driving forces
• Evaluate iteration quality and pace
• Identify anomalous iterations (rollback, rework, over-design)

Extensibility Assessment

• Development extensibility (modularity, interfaces, configurability)
• Requirement upgrade extensibility (data model, API compatibility)
• User growth extensibility (performance, caching, horizontal scaling)

Market Roadmap Planning

• Feature coverage analysis
• Requirement trend analysis
• Short/mid/long-term development roadmap

Requirement-Code Deviation Analysis

• Feature gaps (required but not implemented)
• Over-implementation (implemented but not required)
• Understanding gaps (implementation doesn't match intent)
• Documentation lag (code changed, docs not updated)

Upgrade Vulnerability Identification

• Data model fragility
• API incompatibility risks
• Hardcoded traps
• Test blind spots
• Dependency coupling

Trigger Patterns

"需求分析", "需求评审", "需求评估"
"设计评审", "设计评估", "设计原理分析"
"迭代评估", "迭代分析", "迭代回顾"
"扩展性评估", "扩展性分析", "架构评估"
"市场规划", "产品规划", "发展路线"
"需求偏差", "需求偏差分析", "代码与需求对比"
"升级风险", "升级漏洞", "技术债务评估"
"全面分析", "需求分析师"
"requirement analysis", "design review"
"iteration review", "extensibility assessment"
"market roadmap", "requirement deviation"
"upgrade risk", "technical debt"

Output Format

Comprehensive Report

┌─────────────────────────────────────────────────────┐
│ Requirement Analysis Report                         │
├─────────────────────────────────────────────────────┤
│ Project: {project_name}                             │
│ Analysis Scope: {dimensions}                        │
│ Overall Score: {score}/100                          │
├─────────────────────────────────────────────────────┤
│ Dimension Scores:                                   │
│ • Historical Design:  {score}/100                   │
│ • Iteration Rationale: {score}/100                  │
│ • Extensibility:       {score}/100                  │
│ • Market Roadmap:      {score}/100                  │
│ • Req-Code Deviation:  {score}/100                  │
│ • Upgrade Vulnerability: {score}/100                │
├─────────────────────────────────────────────────────┤
│ Key Findings:                                       │
│ • {finding_1}                                       │
│ • {finding_2}                                       │
├─────────────────────────────────────────────────────┤
│ Priority Actions:                                   │
│ P0: {action_1}                                      │
│ P1: {action_2}                                      │
│ P2: {action_3}                                      │
└─────────────────────────────────────────────────────┘

Single Dimension Report

┌─────────────────────────────────────────────────────┐
│ {Dimension} Assessment Report                       │
├─────────────────────────────────────────────────────┤
│ Score: {score}/100                                  │
│ Status: {status}                                    │
├─────────────────────────────────────────────────────┤
│ Findings:                                           │
│ 1. {finding} - {severity}                           │
│ 2. {finding} - {severity}                           │
├─────────────────────────────────────────────────────┤
│ Recommendations:                                    │
│ • {recommendation}                                  │
└─────────────────────────────────────────────────────┘

Analysis Dimensions Detail

Dimension 1: Historical Design Principles

Dimension 2: Iteration Rationale

Dimension 3: Extensibility

Dimension 4: Market Roadmap

Dimension 5: Requirement-Code Deviation

Dimension 6: Upgrade Vulnerability

Parallel Execution（全局唯一 → 维度各自并行 → 结果合并唯一）

用户要求 ≥3 个维度的综合分析时，六维度互相独立、读不同来源，按维度并行：全局唯一（一份综合报告、一个总评分，主 agent 汇总）→ 每维度一个只读单元并行分析（历史设计原理 / 迭代演进 / 扩展性 / 市场路线 / 需求偏差 / 升级漏洞，各自只读对应来源，返回该维度模板段落不展开长文）→ 合并唯一（主 agent 交叉验证冲突项并调和，产出唯一报告；子单元不出总评分、不单独沉淀知识）。并发 ≤ 4，六维全开时分两批。单一维度请求保持串行。

宿主支持并行子 agent 时按维度并行派发；flowmind 运行时内退化为串行逐维度执行，输出结构不变。

Learning Integration

This skill supports FlowMind learning:

• Analysis Focus: Learns which dimensions you care about most
• Severity Threshold: Learns your risk tolerance
• Report Format: Learns preferred report detail level

Examples

Example 1: Full Requirement Analysis

User: 对当前项目做一次全面需求分析

FlowMind:
┌─────────────────────────────────────────────────────┐
│ Requirement Analysis Report                         │
├─────────────────────────────────────────────────────┤
│ Project: order-service                              │
│ Analysis Scope: All 6 dimensions                    │
│ Overall Score: 72/100                               │
├─────────────────────────────────────────────────────┤
│ Dimension Scores:                                   │
│ • Historical Design:  75/100                        │
│ • Iteration Rationale: 80/100                       │
│ • Extensibility:       65/100                       │
│ • Market Roadmap:      70/100                       │
│ • Req-Code Deviation:  68/100                       │
│ • Upgrade Vulnerability: 62/100                     │
├─────────────────────────────────────────────────────┤
│ Key Findings:                                       │
│ • Order state machine lacks extensibility           │
│ • 3 features have requirement-code deviation        │
│ • Redis caching strategy needs redesign for scale   │
├─────────────────────────────────────────────────────┤
│ P0: Fix state machine deadlocks in refund flow      │
│ P1: Align 3 deviated features with requirements     │
│ P2: Redesign Redis caching for 10x user growth      │
└─────────────────────────────────────────────────────┘

Example 2: Upgrade Risk Assessment

User: 评估一下需求升级的风险

FlowMind:
┌─────────────────────────────────────────────────────┐
│ Upgrade Vulnerability Report                        │
├─────────────────────────────────────────────────────┤
│ Vulnerabilities Found: 8                            │
│ • HIGH: 2                                           │
│ • MEDIUM: 3                                         │
│ • LOW: 3                                            │
├─────────────────────────────────────────────────────┤
│ 🔴 HIGH: Order status enum hardcoded (OrderService) │
│    Impact: All order operations                     │
│    Fix: Extract to configuration                    │
│                                                    │
│ 🔴 HIGH: No index on order_items.product_id         │
│    Impact: Query performance at scale               │
│    Fix: Add composite index                         │
│                                                    │
│ 🟡 MEDIUM: Payment API v1 deprecated                │
│    Impact: Payment processing                       │
│    Fix: Migrate to v2 API                           │
└─────────────────────────────────────────────────────┘

Configuration

{
  "requirement-analyst": {
    "dimensions": {
      "historicalDesign": true,
      "iterationRationale": true,
      "extensibility": true,
      "marketRoadmap": true,
      "reqCodeDeviation": true,
      "upgradeVulnerability": true
    },
    "scoringWeights": {
      "historicalDesign": 0.15,
      "iterationRationale": 0.15,
      "extensibility": 0.20,
      "marketRoadmap": 0.15,
      "reqCodeDeviation": 0.15,
      "upgradeVulnerability": 0.20
    },
    "reportFormat": "detailed"
  }
}