name: validate description: “验证规范对模式和质量规则的合规性。” argument-hint: “<路径到规范文件>” allowed-tools: Read, Glob, Grep, Skill, Task
验证规范
验证规范对标准模式和质量规则的合规性。
工作流程
-
加载规范
- 读取规范文件
- 解析YAML前内容和内容
-
模式验证
- 启动
spec-reviewer validate代理 - 检查必填字段是否存在
- 验证字段格式
- 检查需求ID模式
- 启动
-
EARS模式验证
- 验证所有需求使用EARS格式
- 检查模式语法正确性
- 识别格式错误的需求
-
验收标准验证
- 验证所有需求都有验收标准
- 检查Given/When/Then格式
- 识别缺失或不完整的标准
-
质量评估
- 计算每个需求的INVEST分数
- 检查模糊语言
- 识别缺失的部分
-
报告结果
- 显示验证状态(通过/失败)
- 按严重性列出问题
- 提供修复指导
参数
$ARGUMENTS- 规范文件的路径
示例
# 验证特定规范
/spec-driven-development:validate .specs/user-auth/spec.md
# 验证所有规范
/spec-driven-development:validate --all
验证报告
# 验证报告: user-auth
**状态:** ⚠️ 通过但带有警告
**时间戳:** 2024-01-15T10:30:00Z
## 模式合规性
✓ 所有必填字段存在
✓ 有效的前内容格式
✓ 需求ID遵循模式
## EARS格式
✓ FR-1: 有效的事件驱动模式
✓ FR-2: 有效的状态驱动模式
⚠️ FR-3: 缺失SHALL关键词
## 验收标准
✓ 所有需求都有标准
✓ Given/When/Then格式正确
⚠️ FR-2.AC-3: 模糊的“then”子句
## INVEST分数
| 需求 | I | N | V | E | S | T | 总分 |
| --- | - | - | - | - | - | - | ----- |
| FR-1 | 2 | 2 | 2 | 2 | 2 | 2 | 12/12 |
| FR-2 | 2 | 2 | 2 | 1 | 2 | 1 | 10/12 |
| FR-3 | 2 | 2 | 2 | 2 | 1 | 2 | 11/12 |
## 建议
1. FR-3: 添加SHALL关键词以符合EARS要求
2. FR-2.AC-3: 使结果更具体
相关命令
/spec-driven-development:audit- 带评分的全面质量审计/spec-driven-development:refine- AI辅助的精炼/spec-driven-development:specify- 生成新规范