⚡

规范质量审计Skill audit

该技能用于对软件规范进行全面的质量审计，通过正式评分评估其结构、需求、验收标准等，生成合规报告并提供改进建议。关键词：规范审计、质量评估、合规报告、软件需求、测试标准、敏捷开发、需求分析。

测试 0 次安装 0 次浏览 更新于 3/11/2026

name: audit description: “审计规范质量并生成合规报告。” argument-hint: “<规范文件路径或 --all>” allowed-tools: 读取, 全局, 搜索, 技能, 任务

审计规范质量

执行规范的全面质量审计，并提供正式评分。

工作流程

  1. 加载规范

    • 如果提供路径，审计单个规范
    • 如果使用 --all 标志，审计 .specs/ 目录中的所有规范

  2. 执行审计

    • 启动 spec-reviewer audit 代理
    • 根据质量评估标准进行评估
    • 对每个类别进行评分

  3. 生成报告

    • 总体等级（A-F 等级）
    • 类别分数
    • 按严重程度的问题详情
    • 修复指导

参数

  • $ARGUMENTS - 规范文件路径
  • --all - 审计所有规范
  • --format - 输出格式：markdown（默认）, json

示例

# 审计单个规范
/spec-driven-development:audit .specs/user-auth/spec.md

# 审计所有规范
/spec-driven-development:audit --all

# 为工具使用 JSON 输出
/spec-driven-development:audit .specs/user-auth/spec.md --format json

评分标准

类别 权重 标准
结构 20% 必需部分、前注、组织性
需求 25% EARS 格式、完整性、清晰度
验收标准 25% Given/When/Then 格式、覆盖率、可测试性
可追溯性 15% 标识符、交叉引用、依赖关系
质量 15% INVEST 评分、无歧义、特异性

等级阈值

等级 分数 状态
A+ 95-100 卓越
A 90-94 优秀
B 80-89 良好
C 70-79 可接受
D 60-69 需改进
F <60 不合格

审计报告

# 规范审计报告

**规范：** user-auth
**审计时间：** 2024-01-15T10:30:00Z
**等级：** B (84/100)

## 类别分数

| 类别 | 分数 | 最大值 | 百分比 |
| --- | --- | --- | --- |
| 结构 | 18 | 20 | 90% |
| 需求 | 21 | 25 | 84% |
| 验收标准 | 20 | 25 | 80% |
| 可追溯性 | 13 | 15 | 87% |
| 质量 | 12 | 15 | 80% |
| **总计** | **84** | **100** | **84%** |

## 发现的问题

### 严重 (0)
无

### 主要 (2)
1. **FR-3:** 错误情况缺失验收标准
2. **NFR-1:** 性能阈值不可测试

### 次要 (3)
1. **FR-1.AC-2:** 可更具体
2. **FR-2:** 考虑拆分为更小需求
3. **依赖关系:** 缺失 FR-1 链接

## 建议

1. 为 FR-3 错误处理添加验收标准
2. 为 NFR-1 指定可测量阈值
3. 考虑优化 FR-2 以提高 INVEST 评分

## 比较（如存在先前审计）

| 指标 | 先前 | 当前 | 变化 |
| --- | --- | --- | --- |
| 等级 | C (75) | B (84) | +9 |
| 问题数 | 8 | 5 | -3 |

相关命令

  • /spec-driven-development:validate - 快速验证检查
  • /spec-driven-development:refine - AI 辅助改进
  • /spec-driven-development:status - 查看规范状态