superpowers｜完成前验证技能

资源介绍

verification-before-completion 是 superpowers 仓库中的一个 AI 技能，用于确保 AI 在声称工作完成、修复或通过之前，必须运行验证命令并确认输出。它强调“证据先于断言”，并提供了详细的流程和示例，帮助 AI 避免常见的验证陷阱。

Skill 能力

铁律：无验证证据不得声称完成

任何完成声明都必须基于当前消息中运行的验证命令的输出，否则视为撒谎。

门控函数：五步验证流程

识别验证命令、运行完整命令、读取输出、确认结果、然后才做出声明。

常见失败模式清单

列出测试通过、代码检查、构建成功等常见声明的必要证据，防止不充分验证。

红旗警示与合理化预防

识别“应该”、“可能”等模糊措辞，并针对常见借口提供现实检查。

关键模式示例

提供测试、回归测试、构建、需求验证和代理委派等场景的正确与错误示例。

资源配置

适用平台

Claude CodeCodex

支持模型

模型无关

调用方式

自动触发规则匹配

安装与调用

1. 01

   在声称完成、修复或通过之前，先运行验证命令并确认输出。

2. 02

   遵循门控函数：识别、运行、读取、验证、声明。

3. 03

   避免使用“应该”、“可能”等模糊措辞，始终提供证据。

使用案例

测试通过声明

使用场景AI 完成代码修改后，声称所有测试通过。

正确做法：运行测试命令，看到 34/34 通过，然后说“所有测试通过”。错误做法：说“应该能通过”或“看起来正确”。

回归测试验证

使用场景AI 编写了回归测试，声称测试有效。

正确做法：执行红绿循环，先写测试并运行通过，然后还原修复，确认测试失败，再恢复修复，确认通过。错误做法：仅声称已编写回归测试，未验证红绿循环。

构建成功声明

使用场景AI 声称构建成功。

正确做法：运行构建命令，确认退出码为 0。错误做法：仅凭代码检查通过或日志看起来正常就声称构建成功。

包含内容

✓

LICENSE-MIT.txt

✓

README-中文安装说明.md

✓

SHA256.txt

✓

superpowers-verification-before-completion-source.zip

常见问题

这个技能适用于哪些场景？

适用于任何需要声称工作完成、修复、通过或表达满意度的场景，包括提交代码、创建 PR、完成任务、委派给其他代理等。

如何安装和使用这个技能？

该技能是 superpowers 仓库的一部分，可以从 GitHub 克隆或下载仓库，然后将 skills/verification-before-completion 目录中的 SKILL.md 文件集成到你的 AI 开发环境中。具体安装方法取决于你的 AI 工具。

这个技能依赖特定的 AI 模型或平台吗？

该技能是模型无关的，适用于任何 AI 开发环境，如 Claude Code、Codex 等。它不依赖特定模型，但需要 AI 能够执行命令并读取输出。

如果验证命令失败怎么办？

如果验证命令失败，应如实报告实际状态，并提供证据，而不是声称成功。技能要求“先有证据，再下结论”，失败也是证据。

这个技能的许可证是什么？

superpowers 仓库的许可证信息未在提供的资料中明确说明，建议查看仓库的 LICENSE 文件以获取详细信息。