AC Coverage | AC 覆蓋率

Generate an Acceptance Criteria (AC) to test traceability matrix and coverage report from a specification file.

從規格檔案產生驗收條件（AC）與測試的追蹤矩陣及覆蓋率報告。

Usage | 用法

/ac-coverage specs/SPEC-001.md            # Analyze specific SPEC
/ac-coverage specs/SPEC-001.md --threshold 90   # Custom threshold
/ac-coverage specs/SPEC-001.md --test-dir tests/ # Specify test directory

Workflow | 工作流程

1. Parse SPEC — Read the specification file and extract all AC definitions (AC-1, AC-2, ...)
2. Scan tests — Search test files for @AC and @SPEC annotations
3. Build matrix — Map each AC to its corresponding test references
4. Classify status — ✅ covered | ⚠️ partial | ❌ uncovered
5. Calculate coverage — Coverage % = (covered + partial × 0.5) / total × 100
6. Generate report — Output standardized Markdown report

How This Differs from /coverage | 與 /coverage 的區別

	/coverage	/ac-coverage
Level	Code (line/branch/function)	Requirements (AC-to-test)
Question	"How much code is tested?"	"Which AC have tests?"
Input	Source code + test runner	SPEC file + test annotations

Both are complementary — use /coverage for code quality, /ac-coverage for requirement verification.

兩者互補 — 使用 /coverage 確保程式碼品質，使用 /ac-coverage 確保需求驗證。

Quality Thresholds | 品質門檻

Context	Default Threshold	Configurable
Check-in	80%	--threshold N
Release	100%	--threshold N
Warning	60%	--threshold N

Output Format | 輸出格式

# AC Coverage Report

**Specification**: SPEC-001 — Feature Name
**Generated**: 2026-03-18
**Coverage**: 75% (6/8 AC)

## Summary

| Status | Count | Percentage |
|--------|-------|------------|
| ✅ Covered | 5 | 62.5% |
| ⚠️ Partial | 2 | 25.0% |
| ❌ Uncovered | 1 | 12.5% |

## Traceability Matrix

| AC-ID | Description | Status | Test Reference |
|-------|-------------|--------|----------------|
| AC-1 | ... | ✅ | test-file.ts:15 |

## Gaps
- **AC-8**: Blocked by external dependency

## Action Items
1. [ ] AC-8: Resolve blocker

Next Steps Guidance | 下一步引導

After /ac-coverage completes, the AI assistant should suggest:

AC 覆蓋率分析完成。建議下一步 / AC coverage analysis complete. Suggested next steps:

• 覆蓋率達標 → 執行 /checkin 品質關卡 — Coverage meets threshold → Run /checkin quality gates
• 有未覆蓋 AC → 執行 /derive-tdd 補齊測試 — Uncovered AC found → Run /derive-tdd to add tests
• 有部分覆蓋 AC → 檢查缺少的邊界情況 — Partial AC → Review missing edge cases

References | 參考

• AC Coverage Assistant Skill
• Core Standard: Acceptance Criteria Traceability
• Related: /coverage (code-level coverage)
• Related: /checkin (quality gates)