完成前验证
用新鲜证据确认工作完成、修复有效或测试通过。
技能明确要求新鲜验证证据、读取完整输出并报告实际状态,降低虚假完成声明风险;但要求执行“完整命令”,未限定命令权限、敏感数据处理、破坏性操作确认、回滚或数据流披露,因此扣分。
规则结构清晰,包含识别命令、执行、读取退出码、核对结果及失败反馈;但未说明依赖缺失、命令失败、环境不一致或无法执行时的诊断路径,且静态审查未执行关键路径,按校准限制扣分。
触发条件和适用场景较明确,覆盖测试、构建、修复、提交和代理委派等完成性声明;但“任何正面表述”过于宽泛,非适用边界、不同代理环境及中文使用说明不足,扣分。
具备名称、描述、概览、核心规则、失败示例和常见模式,仓库上下文提供MIT许可、版本和维护/贡献信息;但技能自身缺少安装依赖、版本变更、故障排查、责任人和更新路径说明,扣分。
核心目标是阻止无证据的完成声明,规则和示例可直接指导代理行为;但没有独立执行机制或技能专属结果验证,效果依赖代理遵守指令,且静态审查无法证明代表性输出,扣分。
源文件本身可审计,规则、反例和所需证据类型明确;但没有该技能的专门测试、第三方执行证据或交叉佐证,静态证据覆盖有限,扣分。
- “运行完整命令”可能导致执行范围过宽;使用前应明确命令来源、权限边界、敏感输出处理及破坏性操作的确认与恢复方案。
- 该技能主要依赖代理自觉遵守文本规则,未提供可执行的强制检查或专属测试。
- “任何正面表述”可能造成过度触发,建议定义不应触发的普通讨论、计划或条件性陈述。
这个 Skill 能做什么,适合哪些场景?
这是 Superpowers 集合中的一个开发流程技能,要求代理在声称工作完成、修复或通过前先获得最新验证证据。它规定代理必须确定能证明结论的完整命令,执行命令并读取完整输出、退出码和失败数量。若证据不支持结论,代理必须报告实际状态;只有证据确认后才能作出成功声明。源文件没有指定某个固定测试、构建或检查命令。
在作出完成或成功声明前,要求代理识别证明该声明的命令,运行完整命令,读取完整输出,检查退出码并统计失败项,然后将结果与声明进行核对。它还要求在提交、创建 PR、委派代理或进入下一项任务前执行相应验证;验证失败时报告实际状态,而不是推测成功。
- 开发者完成代码修改后,需要确认测试确实通过再报告结果。
- 开发者修复缺陷后,需要重新测试原始问题以证明修复有效。
- 开发者准备构建、提交或创建 PR,需要确认完整构建或检查命令成功。
- 使用子代理协作时,需要独立检查代理报告、版本控制差异和实际验证结果。
这个 Skill 有哪些优点和局限?
- 明确要求新鲜、完整的验证证据。
- 覆盖测试、构建、缺陷修复、需求检查和代理委派等常见声明。
- 失败时要求报告实际状态,减少无证据的成功判断。
- 不会自动选择项目专用的测试或构建命令。
- 源文件未提供独立安装流程或可执行脚本。
- 验证效果取决于代理是否正确识别并运行完整命令。
如何安装这个 Skill?
该技能属于 obra/superpowers 仓库的 14 个技能组成的集合。README 未提供此技能的独立安装步骤;请按所用 harness 安装整个 Superpowers 集合。例如 Codex CLI 使用 /plugins,搜索 superpowers 并选择 Install Plugin;Codex App 可在 Plugins 侧栏的 Coding 分类中安装 Superpowers。
如何使用这个 Skill?
在即将报告完成、修复或通过时触发。例如:请先运行能够完整证明测试结果的验证命令,读取完整输出和退出码,再报告实际状态。 具体验证命令由项目和所要证明的结论决定,源文件未规定固定命令。