用途:validate-plan 是 agents-workflow 开发流程的第三环,在功能实现完成后、合并前,对照技术规格验证代码质量、测试覆盖与规格一致性。
主要能力:分阶段执行环境准备、规格对齐分析、测试执行、质量门禁、验证报告生成,并支持 --fix 自动修复常见问题。规格对齐会检查 API 端点、数据模型、业务逻辑、安全措施、性能与错误处理是否符合 docs/specs/{feature-name}-spec.md。测试执行覆盖单元测试(要求覆盖率至少 80%)、集成测试与端到端测试,并生成覆盖率报告。质量门禁按 PASS、PARTIAL、FAIL 三档给出合并建议。
使用方式:命令为 /skill:validate <feature-name>,可选参数包括 --tests-only、--spec-only、--coverage-only、--fix。前置条件为已通过 /skill:swarm 完成实现、存在 feat/{feature-name} 分支、存在规格文件 docs/specs/{feature-name}-spec.md,并已配置测试工具(如 Vitest、Playwright)。验证报告输出到 docs/validation/{feature-name}-validation.md。可选配置 .validate.json 可设置覆盖率阈值、测试命令与 autoFix 项。
适用场景:需要将实现与规格逐项核对、确保测试覆盖达标、在合并前获得结构化验证结论的团队开发流程。
限制:资料未提供具体支持的测试框架完整列表、自动修复的覆盖范围细节、与 CI 系统的集成方式,以及除示例外的实际效果数据。