cenmiao/openspec-sp-verify-before-complete

Verification Before Completion Skill

核心规则：NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

证据先于断言。在报告完成前，必须有验证证据。

---

何时使用

在以下情况前必须执行验证：

• 报告任务完成前
• 输出成功报告前
• 表达满意度前
• 转移到下一个任务前

---

验证流程

┌─────────────────────────────────────────────────────────┐
│  Verification Before Completion Process                 │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  1. 选择验证方法                                        │
│     ┌─────────────────────────────────────┐            │
│     │ 根据变更内容选择：                  │            │
│     │ - 测试套件 → 运行测试               │            │
│     │ - 编译项目 → 确认 exit code 0       │            │
│     │ - 缺陷修复 → 测试原始症状           │            │
│     │ - 自动化代理 → 独立检查             │            │
│     └─────────────────────────────────────┘            │
│           │                                            │
│           ▼                                            │
│  2. 执行验证                                          │
│     - 运行验证命令                                    │
│     - 读取输出结果                                    │
│                                                         │
│           ▼                                            │
│  3. 确认断言有证据支持                                │
│     - 检查验证结果                                    │
│     - 确认所有断言被证实                              │
│                                                         │
│           ▼                                            │
│  4. 然后才能输出                                      │
│     - 完成报告                                        │
│     - 满意度表达                                      │
│     - 任务转换                                        │
│                                                         │
└─────────────────────────────────────────────────────────┘

---

验证方法

1. 测试套件

# 运行测试
npm test
pytest
cargo test

验证标准：

• 零失败
• 所有相关测试通过

2. 编译项目

# 编译/构建
npm run build
cargo build
go build

验证标准：

• Exit code 0
• 无错误输出

3. 缺陷修复

验证步骤：

1. 重现原始症状
2. 确认症状已消失
3. 运行回归测试

4. 自动化代理

验证步骤：

1. 运行独立检查脚本
2. 读取检查结果
3. 确认所有检查通过

---

禁止的词汇

❌ 模糊词汇

| 禁止 | 原因 | |------|------| | "should work" | 未验证 | | "probably fixed" | 未验证 | | "seems like it's done" | 未验证 | | "I'm confident" | 信心≠证据 |

✅ 正确表达

| 使用 | 原因 | |------|------| | "Tests pass: 42/42" | 有证据 | | "Build succeeded (exit 0)" | 有证据 | | "Verified: symptom X is gone" | 有证据 |

---

禁止的表演性回应

当收到验证反馈时：

❌ 禁止的回应

• "You're absolutely right!"
• "Great point!"
• "Excellent feedback!"
• "Let me implement that now"（未验证前）

✅ 正确的回应模式

1. 阅读完整反馈 - 不立即反应
2. 复述需求 - 用自己的话或询问确认
3. 验证反馈 - 与代码库实际对照
4. 技术评估 - 评估正确性
5. 响应 - 技术确认或合理反驳
6. 逐个实现 - 逐个测试

---

使用示例

示例 1：任务完成前

用户：这个功能完成了吗？

❌ 错误回答：
"是的，应该完成了。我很有信心。"

✅ 正确回答：
"让我验证一下。

[运行测试]
[读取输出]

验证结果：
- ✅ 测试通过：24/24
- ✅ 构建成功：exit 0
- ✅ 手动验证：功能正常工作

完成！功能已验证。"

示例 2：修复 Bug 后

用户：Bug 修复了吗？

❌ 错误回答：
"应该修复了，看起来没问题。"

✅ 正确回答：
"让我重现原始症状来验证。

[重现步骤]
[读取输出]

验证结果：
- ✅ 原始错误不再出现
- ✅ 回归测试通过

Bug 已修复并验证。"

---

验证清单

在任何完成报告前，确认：

• [ ] 已选择适当的验证方法
• [ ] 已执行验证并读取输出
• [ ] 所有断言有证据支持
• [ ] 未使用模糊词汇
• [ ] 未使用表演性回应

---

与其他技能集成

• openspec-sp-tdd: TDD 循环完成后验证
• openspec-verify-change: 验证流程的核心部分
• openspec-apply-change: 每任务完成后验证

---

核心原则总结

1. 证据先于断言 - 没有验证就没有完成声明
2. 读取输出 - 实际读取，不要假设
3. 精确语言 - 避免模糊词汇
4. 表演性同意禁止 - 验证后响应