| 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 有测试？」 |
| 输出 | 覆盖率百分比 | 追踪矩阵 + 缺口报告 |
工作流程
- 解析 SPEC — 从规格文件中抽取 AC 定义（AC-1, AC-2, ...）
- 扫描测试 — 搜索测试文件中的规范标注
@SPEC-<id> @AC-<n>（单一合并标签）
- 构建矩阵 — 将每个 AC 对应到其测试引用（文件、测试名称、行号）
- 分类状态 — 将每个 AC 标记为 ✅ 已覆盖、⚠️ 部分覆盖、或 ❌ 未覆盖
- 计算覆盖率 — 套用公式：
覆盖率 % = (已覆盖 + 部分覆盖 × 0.5) / 总数 × 100
- 生成报告 — 输出标准化的 Markdown 报告
链接标注约定
测试必须使用 canonical 合并标注 @SPEC-<id> @AC-<n>（单一合并标签、保持同一行；勿拆成 @AC / @SPEC 两行）引用其来源 AC：
describe('AC-1: User login with valid credentials', () => {
it('should redirect to dashboard on successful login', () => { ... });
});
:
(): ...
