Vs Coverage Check

---
name: vs-coverage-check
description: 检查每个US是否有对应的VS，生成覆盖率报告和修复建议。当设计文档创建后、CONSTRAINT验收前使用，避免US→VS覆盖率<100%导致验收失败。
stage: DESIGN
level_supported: [L1, L2, L3]
---

## vs-coverage-check: 设计覆盖率检查

### 描述
检查每个 US 是否有对应的 VS，生成覆盖率报告和修复建议。当设计文档创建后、CONSTRAINT 验收前使用，避免 US→VS 覆盖率 <100% 导致验收失败。

### 适用场景
- **WORKFLOW_STEP_4 Task S4-2 Round 2**：设计文档创建后
- **WORKFLOW_STEP_4 Task S4-5 前**：准备进入 CONSTRAINT 验收前
- **自检工具**：提前发现覆盖缺口，避免验收失败

### 输入
- requirements/ 目录（所有 US）
- design/ 目录（所有 VS）

### 输出
- VS 覆盖率报告（markdown）
- 覆盖率百分比（如"85%，12/14 个 US 有对应 VS"）
- 缺失的 US 清单（哪些 US 没有对应 VS）
- 修复建议（建议创建哪些 VS）

### 执行策略
1. 扫描 requirements/ 目录，提取所有 US-ID（格式：US-<SN>-NNN，参考 CRAFT_L{LEVEL}_REQUIREMENTS.md）
2. 扫描 design/ 目录，提取所有 VS 的 source_us 字段（Front Matter 必填字段，参考 CRAFT_L{LEVEL}_DESIGN.md）
3. 计算覆盖率（VS 覆盖的 US 数量 / 总 US 数量）
4. 识别缺失的 US（未被任何 VS 的 source_us 引用）
5. 生成修复建议（建议创建 VS-<SN>-NNN，派生自缺失的 US）

### 价值
- **SPEC 组织**：提前发现 US→VS 覆盖缺口，避免 CONSTRAINT 验收失败
- **PM/BA**：确保所有需求都有设计
- **Dev**：完整的设计视图，无遗漏