ac-coverage

name	ac-coverage
source	../../../../skills/ac-coverage/SKILL.md
source_version	1.1.0
translation_version	1.1.0
last_synced	"2026-07-09T00:00:00.000Z"
source_hash	eac0755fd844
scope	universal
status	current
description	[UDS] 分析验收条件（AC）与测试之间的追踪关系并生成覆盖率报告
allowed-tools	Read, Grep, Glob
argument-hint	[规格文件路径]

AC 覆盖率助手

语言: English | 简体中文

版本: 1.1.0 最后更新: 2026-06-19 适用范围: Claude Code Skills

核心标准: 本技能实现验收标准可追踪性标准。如需权威方法论，请参阅核心标准。

分析验收条件（AC）与测试之间的追踪关系，并生成覆盖率报告。

与 /coverage 的区别

方面	/coverage	/ac-coverage
范围	代码层级（行数／分支／函数）	需求层级（AC 对应测试）
输入	源代码 + 测试运行器	SPEC 文件 + 测试标注
问题	「代码测试了多少？」	「哪些 AC 有测试？」
输出	覆盖率百分比	追踪矩阵 + 缺口报告

工作流程

1. 解析 SPEC — 从规格文件中抽取 AC 定义（AC-1, AC-2, ...）
2. 扫描测试 — 搜索测试文件中的规范标注 @SPEC-<id> @AC-<n>（单一合并标签）
3. 构建矩阵 — 将每个 AC 对应到其测试引用（文件、测试名称、行号）
4. 分类状态 — 将每个 AC 标记为 ✅ 已覆盖、⚠️ 部分覆盖、或 ❌ 未覆盖
5. 计算覆盖率 — 套用公式：覆盖率 % = (已覆盖 + 部分覆盖 × 0.5) / 总数 × 100
6. 生成报告 — 输出标准化的 Markdown 报告

链接标注约定

测试必须使用 canonical 合并标注 @SPEC-<id> @AC-<n>（单一合并标签、保持同一行；勿拆成 @AC / @SPEC 两行）引用其来源 AC：

// TypeScript/JavaScript
describe('AC-1: User login with valid credentials', () => {
  // @SPEC-001 @AC-1
  it('should redirect to dashboard on successful login', () => { ... });
});

# Python
 :
    
     (): ...