spec-verify

name	spec:verify
description	Use when verifying completed features against their spec through visual audit, boundary testing, and regression checks - triggers on /spec:verify, 验证, 检查, 验收

功能验证工作流 (Verify)

对已完成的功能进行视觉审计、边界测试和回归检查，生成验证报告。

前置: 必须先有 specs/[feature_name]/spec.md 和已完成的代码修改 产物: specs/[feature_name]/verify_report.md

⚠️ 验证标准（开始前必读）

验证报告必须同时满足以下指标：

#	检查项	合格标准
1	环境确认	明确记录 npm run build 是否成功、dist/ 是否为最新
2	视觉审计	逐条对比 spec.md 的视觉需求，每条给出 ✅/❌ 判定
3	边界测试	逐条对比 spec.md 的边界情况，每条给出测试结果
4	回归检查	确认无已有功能退化
5	最终结论	明确给出 通过 / 不通过 的总判定

验证指令

1. 环境确认

• 执行 npm run build，确认编译通过且 dist/ 目录产物为最新
• 提醒用户在 Cocos Creator 编辑器中重新加载插件（开发者 → 重新加载）
• 记录编译结果：通过/失败 + 时间戳

2. 视觉审计

• 加载 specs/[feature_name]/spec.md 的 视觉需求 章节
• 请求用户在编辑器中操作新功能/修复项并提供截图
• 逐条对比，输出结果表格：

| # | 视觉需求描述 | 判定 | 差异说明 |
|---|-------------|------|---------|
| 1 | xxx 最小宽度 120px | ✅ 符合 | — |
| 2 | 窄模式下自动换行 | ❌ 不符 | 仍为单行 |

3. 逻辑审计

• 加载 spec.md 的 边界情况 章节
• 逐条转化为测试用例，请求用户执行并反馈结果：

| # | 边界场景 | 测试步骤 | 期望结果 | 实际结果 | 判定 |
|---|---------|---------|---------|---------|------|
| 1 | 500px 临界值抖动 | 反复拖拽经过 500px | 平滑切换 | ? | ✅/❌ |
| 2 | 极窄面板保护 | 面板拖到最窄 | 选择框 ≥ 120px | ? | ✅/❌ |

• 检查编辑器控制台是否存在新增报错或警告信息

4. 回归检查

确认修改未破坏原有功能。重点检查：

• 正常宽度下工具栏布局是否保持不变
• 按钮功能是否正常（刷新/暂停/FPS/拾取等）
• 分辨率切换 + 横竖屏切换是否正常工作
• Webview 游戏画面是否正常显示

5. 输出报告

创建 specs/[feature_name]/verify_report.md，必须包含以下结构：

# 验证报告 - [功能名称]

## 测试环境
- 日期：YYYY-MM-DD
- 编译状态：通过/失败
- 编辑器版本：Cocos Creator 2.4.x

## 视觉审计结果
（逐条表格）

## 边界测试结果
（逐条表格）

## 回归检查结果
- [ ] 正常宽度布局正常
- [ ] 按钮功能正常
- [ ] 分辨率切换正常
- [ ] 游戏画面正常

## 最终结论
**✅ 通过** / **❌ 不通过**（附不通过原因）

• 语言要求: 报告所有文字描述均须使用简体中文

6. 汇报

回复用户时，简要总结验证结论：

• 通过了多少项 / 总共多少项
• 如有不通过项，列出最关键的 1-2 个问题
• 建议下一步操作（修复后重新验证，或发布）