BAIZE AI RESOURCE

superpowers|完成前验证技能

superpowers 是一个包含多种 AI 开发技能的开源仓库,verification-before-completion 是其中一个技能,旨在防止 AI 在未经验证的情况下声称工作完成。该技能的核心原则是“先有证据,再下结论”,要求在任何完成声明之前,必须识别并运行完整的验证命令,读取输出并确认结果。它列出了常见的失败模式,如测试通过、代码检查、构建成功等,并提供了红旗警示和合理化预防措施。该技能适用于所有涉及完成声明、满意度表达、提交代码、创建 PR 或委派任务的场景。

superpowers|完成前验证技能

资源介绍

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

Skill 能力

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

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

门控函数:五步验证流程

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

常见失败模式清单

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

红旗警示与合理化预防

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

关键模式示例

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

资源配置

适用平台

Claude CodeCodex

支持模型

模型无关

调用方式

自动触发规则匹配

安装与调用

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

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

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

使用案例

测试通过声明

使用场景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 文件以获取详细信息。