name: “QE需求验证” description: “需求可追溯性、验收标准验证和BDD场景管理，以实现完整的需求覆盖。” trust_tier: 3 validation: schema_path: schemas/output.json validator_path: scripts/validate-config.json eval_path: evals/qe-requirements-validation.yaml

QE需求验证

目的

指导使用v3的需求验证功能，包括验收标准解析、需求可追溯性、BDD场景生成和覆盖缺口识别。

激活时机

当验证需求时
当追踪需求到测试时
当生成BDD场景时
当评估需求覆盖时
当审查验收标准时

快速开始

# 解析验收标准
aqe requirements parse --source jira --project MYAPP

# 构建可追溯性矩阵
aqe requirements trace --requirements reqs/ --tests tests/

# 生成BDD场景
aqe requirements bdd --story US-123 --output features/

# 检查需求覆盖
aqe requirements coverage --sprint current

代理工作流

// 需求验证
Task("验证验收标准", `
  审查冲刺故事的验收标准：
  - 检查SMART标准（具体、可衡量、可实现、相关、可测试）
  - 识别模糊需求
  - 标记缺失边缘情况
  - 提出改进建议
`, "qe-acceptance-criteria")

// 可追溯性矩阵
Task("构建可追溯性", `
  创建需求可追溯性矩阵：
  - 映射用户故事到测试用例
  - 识别未测试需求
  - 查找孤立测试（无关联需求）
  - 计算覆盖指标
`, "qe-traceability-builder")

需求操作

1. 验收标准验证

await acceptanceCriteria.validate({
  source: {
    type: 'jira',
    project: 'MYAPP',
    stories: 'sprint=current'
  },
  validation: {
    specific: true,
    measurable: true,
    achievable: true,
    relevant: true,
    testable: true
  },
  output: {
    score: true,
    issues: true,
    suggestions: true
  }
});

2. 可追溯性矩阵

await traceabilityBuilder.build({
  requirements: {
    source: 'jira',
    types: ['story', 'task', 'bug']
  },
  artifacts: {
    tests: 'tests/**/*.test.ts',
    code: 'src/**/*.ts',
    documentation: 'docs/**/*.md'
  },
  output: {
    matrix: true,
    coverage: true,
    gaps: true,
    orphans: true
  }
});

3. BDD场景生成

await bddGenerator.generate({
  requirements: userStory,
  format: 'gherkin',
  scenarios: {
    happyPath: true,
    edgeCases: true,
    errorCases: true,
    dataVariations: true
  },
  output: {
    featureFile: true,
    stepDefinitions: 'skeleton'
  }
});

4. 覆盖分析

await requirementsCoverage.analyze({
  scope: 'sprint-23',
  metrics: {
    requirementsCovered: true,
    testCasesCoverage: true,
    automationCoverage: true,
    riskAssessment: true
  },
  report: {
    summary: true,
    details: true,
    recommendations: true
  }
});

可追溯性矩阵

interface TraceabilityMatrix {
  requirements: {
    id: string;
    title: string;
    type: string;
    priority: string;
    status: string;
    linkedTests: string[];
    linkedCode: string[];
    coverage: 'full' | 'partial' | 'none';
  }[];
  tests: {
    id: string;
    name: string;
    type: 'unit' | 'integration' | 'e2e';
    linkedRequirements: string[];
    automated: boolean;
  }[];
  coverage: {
    requirementsCovered: number;
    requirementsPartial: number;
    requirementsUncovered: number;
    orphanTests: number;
  };
  gaps: {
    requirement: string;
    missingCoverage: string[];
    risk: 'high' | 'medium' | 'low';
  }[];
}

BDD集成

# 生成的特征文件
Feature: 用户注册
  As a new user
  I want to create an account
  So that I can access the platform

  @happy-path
  Scenario: 使用有效详情成功注册
    Given I am on the registration page
    When I enter valid email "user@example.com"
    And I enter valid password "SecurePass123!"
    And I click the register button
    Then I should see a success message
    And I should receive a confirmation email

  @edge-case
  Scenario: 使用已存在邮箱注册
    Given a user exists with email "existing@example.com"
    When I try to register with email "existing@example.com"
    Then I should see an error "Email already registered"

需求质量

quality_checks:
  acceptance_criteria:
    has_given_when_then: preferred
    is_testable: required
    is_measurable: required
    no_ambiguity: required

  user_story:
    follows_template: "As a <role>, I want <feature>, so that <benefit>"
    has_acceptance_criteria: required
    estimated: preferred

  completeness:
    edge_cases_identified: required
    error_scenarios_covered: required
    non_functional_considered: preferred

冲刺集成

await requirementsValidator.sprintReview({
  sprint: 'current',
  checks: {
    storiesComplete: true,
    criteriaValidated: true,
    testsLinked: true,
    coverageAdequate: true
  },
  gates: {
    minCoverage: 80,
    maxUntested: 2,
    requireDemo: true
  }
});

协调

主要代理: qe-acceptance-criteria, qe-traceability-builder, qe-bdd-specialist 协调员: qe-requirements-coordinator 相关技能: qe-test-generation, qe-quality-assessment