规格优化Skill refine

---

name: refine description: “通过AI辅助改进优化规格说明。” argument-hint: “<规格文件路径>” allowed-tools: Read, Glob, Grep, Write, Edit, Skill, Task

优化规格说明

应用AI辅助的精炼来提高规格说明质量。

工作流程

1. 加载规格说明

   • 读取规格文件
   • 解析所有需求和验收标准

2. 分析质量

   • 生成 spec-processor refine 代理
   • 根据INVEST标准评估
   • 评分清晰度和完整性
   • 识别改进机会

3. 生成建议

   • 清晰度增强
   • 缺失的验收标准
   • 歧义解决
   • 需求拆分建议
   • 优先级调整

4. 呈现改进

   • 按类别分组显示建议
   • 指示影响级别（高/中/低）
   • 提供前后对比

5. 应用更改

   • 交互式：确认每个更改
   • 批量：应用所有批准的更改
   • 更新规格文件

参数

• $ARGUMENTS - 规格文件路径
• --auto - 不确认直接应用所有改进
• --focus - 重点领域：清晰度、完整性、可测试性或全部

示例

# 交互式精炼
/spec-driven-development:refine .specs/user-auth/spec.md

# 自动应用所有改进
/spec-driven-development:refine .specs/user-auth/spec.md --auto

# 专注于清晰度
/spec-driven-development:refine .specs/user-auth/spec.md --focus clarity

精炼类别

清晰度增强

• 移除模糊词语（一些、少数、许多等）
• 添加具体值和阈值
• 澄清参与者和系统边界

完整性改进

• 添加缺失的验收标准
• 添加边界情况场景
• 添加错误处理需求

可测试性改进

• 使结果可观察
• 添加验证方法
• 指定期望值

结构改进

• 拆分大需求
• 合并重复项
• 改进需求排序

精炼报告

# 精炼报告: user-auth

## 摘要
- **找到的改进:** 8
- **高影响:** 3
- **中影响:** 4
- **低影响:** 1

## 改进

### 高: FR-2 - 模糊阈值
**之前:**
> 系统应快速响应登录请求。

**之后:**
> 系统应在500ms内响应登录请求（p95）。

**理由:** “快速”是模糊的；具体的SLA是可测试的。

---

### 中: FR-1 - 缺失错误案例
**添加的AC:**
> 给定电子邮件格式无效，当提交时，显示“无效电子邮件格式”错误。

**理由:** 原始AC只覆盖了顺利路径。

相关命令

• /spec-driven-development:validate - 验证规格说明
• /spec-driven-development:audit - 完整质量审计
• /spec-driven-development:specify - 生成新规格说明