这个 Skill 能做什么,适合哪些场景?
这是 Superpowers 集合中的一个开发流程技能,要求代理在声称工作完成、修复或通过前先获得最新验证证据。它规定代理必须确定能证明结论的完整命令,执行命令并读取完整输出、退出码和失败数量。若证据不支持结论,代理必须报告实际状态;只有证据确认后才能作出成功声明。源文件没有指定某个固定测试、构建或检查命令。
在作出完成或成功声明前,要求代理识别证明该声明的命令,运行完整命令,读取完整输出,检查退出码并统计失败项,然后将结果与声明进行核对。它还要求在提交、创建 PR、委派代理或进入下一项任务前执行相应验证;验证失败时报告实际状态,而不是推测成功。
- 开发者完成代码修改后,需要确认测试确实通过再报告结果。
- 开发者修复缺陷后,需要重新测试原始问题以证明修复有效。
- 开发者准备构建、提交或创建 PR,需要确认完整构建或检查命令成功。
- 使用子代理协作时,需要独立检查代理报告、版本控制差异和实际验证结果。
如何安装这个 Skill?
- “运行完整命令”可能导致执行范围过宽;使用前应明确命令来源、权限边界、敏感输出处理及破坏性操作的确认与恢复方案。
- 该技能主要依赖代理自觉遵守文本规则,未提供可执行的强制检查或专属测试。
- “任何正面表述”可能造成过度触发,建议定义不应触发的普通讨论、计划或条件性陈述。
- Shell / 命令行
- 本地文件系统
该技能属于 obra/superpowers 仓库的 14 个技能组成的集合。README 未提供此技能的独立安装步骤;请按所用 harness 安装整个 Superpowers 集合。例如 Codex CLI 使用 /plugins,搜索 superpowers 并选择 Install Plugin;Codex App 可在 Plugins 侧栏的 Coding 分类中安装 Superpowers。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/obra/superpowers.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/verification-before-completion" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
在即将报告完成、修复或通过时触发。例如:请先运行能够完整证明测试结果的验证命令,读取完整输出和退出码,再报告实际状态。 具体验证命令由项目和所要证明的结论决定,源文件未规定固定命令。
这个 Skill 有哪些优点和局限?
- 明确要求新鲜、完整的验证证据。
- 覆盖测试、构建、缺陷修复、需求检查和代理委派等常见声明。
- 失败时要求报告实际状态,减少无证据的成功判断。
- 不会自动选择项目专用的测试或构建命令。
- 源文件未提供独立安装流程或可执行脚本。
- 验证效果取决于代理是否正确识别并运行完整命令。
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| 完成前验证 本页 | 48 · 谨慎使用 | ★ 299k | 16 天前 | MIT |
| 循环验证器 | 51 · 谨慎使用 | ★ 12k | 11 天前 | MIT |
| cmux 合并前审查技能 | 55 · 谨慎使用 | ★ 28k | 11 天前 | NOASSERTION |
| 创建草稿拉取请求 ✓ Microsoft · 官方 | 38 · 不推荐 | ★ 194k | 11 天前 | MIT |
| TDD Guard | 61 · 推荐 | ★ 2.4k | 13 天前 | MIT |
FollowSkills 如何评估这个 Skill?
技能明确要求新鲜验证证据、读取完整输出并报告实际状态,降低虚假完成声明风险;但要求执行“完整命令”,未限定命令权限、敏感数据处理、破坏性操作确认、回滚或数据流披露,因此扣分。
规则结构清晰,包含识别命令、执行、读取退出码、核对结果及失败反馈;但未说明依赖缺失、命令失败、环境不一致或无法执行时的诊断路径,且静态审查未执行关键路径,按校准限制扣分。
触发条件和适用场景较明确,覆盖测试、构建、修复、提交和代理委派等完成性声明;但“任何正面表述”过于宽泛,非适用边界、不同代理环境及中文使用说明不足,扣分。
具备名称、描述、概览、核心规则、失败示例和常见模式,仓库上下文提供MIT许可、版本和维护/贡献信息;但技能自身缺少安装依赖、版本变更、故障排查、责任人和更新路径说明,扣分。
核心目标是阻止无证据的完成声明,规则和示例可直接指导代理行为;但没有独立执行机制或技能专属结果验证,效果依赖代理遵守指令,且静态审查无法证明代表性输出,扣分。
源文件本身可审计,规则、反例和所需证据类型明确;但没有该技能的专门测试、第三方执行证据或交叉佐证,静态证据覆盖有限,扣分。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →