EngramGraph: Skill for Claude Code

AC Coverage Assistant | AC 覆蓋率助手

Version: 1.1.0 Last Updated: 2026-06-19 Applicability: Claude Code Skills

Core Standard: This skill implements Acceptance Criteria Traceability Standards. For the authoritative methodology, refer to the core standard.

Analyze Acceptance Criteria (AC) to test traceability and generate coverage reports.

分析驗收條件（AC）與測試之間的追蹤關係，並產生覆蓋率報告。

What This Does vs /coverage | 與 /coverage 的區別

Aspect	/coverage	/ac-coverage
Scope	Code-level (line/branch/function)	Requirement-level (AC-to-test)
Input	Source code + test runner	SPEC file + test annotations
Question	"How much code is tested?"	"Which AC have tests?"
Output	Coverage percentages	Traceability matrix + gap report

Workflow | 工作流程

1. Parse SPEC — Extract AC definitions (AC-1, AC-2, ...) from the specification file
2. Scan Tests — Search test files for the canonical annotation @SPEC-<id> @AC-<n> (a single combined tag)
3. Build Matrix — Map each AC to its test references (file, test name, line)
4. Classify Status — Mark each AC as ✅ covered, ⚠️ partial, or ❌ uncovered
5. Calculate Coverage — Apply formula: Coverage % = (covered + partial × 0.5) / total × 100
6. Generate Report — Output standardized Markdown report

Linking Convention | 標註慣例

Tests MUST reference their source AC using the canonical annotation: @SPEC-<id> @AC-<n> — a single combined tag, e.g. @SPEC-001 @AC-1. Keeping the attribution on one line is what forward-derivation and test-runner tag filters consume. Do not split it into separate @AC / @SPEC lines.

使用標準合併標註 @SPEC-<id> @AC-<n>（單一合併標籤），保持同一行；勿拆成 @AC / @SPEC 兩行。

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