关于 verification-before-completion
Verification Before Completion 是一项面向 Agent 和开发者的技能，要求在报告工作完成前先取得证据。它为测试、构建、修复、流水线和 Notebook 提供检查与确认步骤。
主要功能
- 01以证据为先的完成检查
- 02确定并运行验证命令
- 03读取完整输出和退出码
- 04提供测试与构建示例
- 05警示不完整验证
适用场景
- 01报告前确认测试通过
- 02检查构建是否成功
- 03验证流水线输出文件
- 04重新运行 Notebook 后再报告成功
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/verification-before-completion确认已加载。
详细介绍
完成前验证
概述
核心原则： 始终先有证据，再做结论。
验证关卡
BEFORE claiming any status:
1. IDENTIFY: What command proves this claim?
2. RUN: Execute the command (fresh, complete)
3. READ: Full output, check exit code
4. VERIFY: Does output confirm the claim?
- If NO: State actual status with evidence
- If YES: State claim WITH evidence
5. ONLY THEN: Make the claim
常见失败情形
| 结论 | 所需证据 | 不足以证明 |
|---|---|---|
| 测试通过 | 测试命令输出：0 个失败 | 之前运行过、“应该能通过” |
| Linter 检查通过 | Linter 输出：0 个错误 | 部分检查 |
| 构建成功 | 构建命令：退出码为 0 | “看起来没问题” |
| Bug 已修复 | 原有症状：已消失 | 代码已更改、想当然地认为已修复 |
| 流水线已完成 | 输出文件存在且有效 | 工具报告成功 |
| Notebook 运行成功 | 所有单元格均已执行且无错误 | 部分单元格已运行 |
危险信号——停止
如果你发现自己：
- 使用“应该”“可能”“似乎”等说法
- 在验证之前就表达满意（“太好了！”“完成了！”）
- 准备在未运行测试的情况下提交
- 依赖不完整的验证
- 未检查输出就相信工具的成功报告
自我辩解
| 借口 | 事实 |
|---|---|
| “现在应该能用了” | 运行验证 |
| “我有把握” | 信心 != 证据 |
| “就这一次” | 没有例外 |
| “工具说成功了” | 独立验证 |
| “部分检查就够了” | 部分检查无法证明任何事 |
关键模式
测试：
CORRECT: [Run test] → [See: 34/34 pass] → "All tests pass"
WRONG: "Should pass now" / "Looks correct"
流水线输出：
CORRECT: [Check output file exists] → [Verify size/format] → "Pipeline produced valid output"
WRONG: "Galaxy shows green" (without checking actual data)
Notebook：
CORRECT: [Restart kernel] → [Run All] → [Check no errors] → "Notebook runs cleanly"
WRONG: "I updated the cell" (without re-running)
归根结底
运行命令。阅读输出。然后再报告结果。
致谢
改编自 obra/superpowers 的 verification-before-completion 技能。
评论
支持 Markdown