Agent skill
vs-coverage-check
检查每个US是否有对应的VS,生成覆盖率报告和修复建议。当设计文档创建后、CONSTRAINT验收前使用,避免US→VS覆盖率<100%导致验收失败。
Install this agent skill to your Project
npx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/main/AGENTIC_SPEC_FORGE/spec_stage_skill/design/vs-coverage-check
SKILL.md
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)
执行策略
- 扫描 requirements/ 目录,提取所有 US-ID(格式:US-<SN>-NNN,参考 CRAFT_L{LEVEL}_REQUIREMENTS.md)
- 扫描 design/ 目录,提取所有 VS 的 source_us 字段(Front Matter 必填字段,参考 CRAFT_L{LEVEL}_DESIGN.md)
- 计算覆盖率(VS 覆盖的 US 数量 / 总 US 数量)
- 识别缺失的 US(未被任何 VS 的 source_us 引用)
- 生成修复建议(建议创建 VS-<SN>-NNN,派生自缺失的 US)
价值
- SPEC 组织:提前发现 US→VS 覆盖缺口,避免 CONSTRAINT 验收失败
- PM/BA:确保所有需求都有设计
- Dev:完整的设计视图,无遗漏
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
code-review
执行代码审查流程(提交PR→自查→同行审查→反馈修改→合并),覆盖功能正确性、代码质量、测试完整性、安全合规四大维度。当提交Pull Request、进行结对编程、执行代码走查、需要知识共享时使用。支持L1/L2/L3三级审查深度。
code-quality
执行代码质量门禁检查(测试通过→覆盖率→Lint→GOAL追溯→可提交),验证单元测试覆盖率≥80%、集成测试通过率≥95%、代码规范零错误。当完成代码实现、准备提交代码、需要质量验证、进行提交前自检时使用。确保代码可合并。
tdd-cycle
执行 TDD 红绿重构循环(RED→GREEN→REFACTOR→REPEAT),通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。
refactoring
执行代码重构(识别坏味道→选择手法→小步修改→运行测试),在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。
arch-options-compare
比较多个架构方案(单体/微服务等),从SOLID原则、成本、复杂度等维度评分,生成对比表和推荐方案。当需要向客户解释架构选择或ADR决策时使用。
dev-tech-view-supplement
根据设计补充Dev视角的技术细节(数据库/API/通信协议),帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。
Didn't find tool you were looking for?