Skill/开发测试/Verification Before Completion
开发测试 · 卡兹克推荐 309.8k 仓库 Star

Verification Before Completion

用实际检查结果说明完成状态

完成前验证用于核对工作结论是否有证据支持。它先明确要证明什么,再运行相应构建、测试或操作检查,阅读完整输出和退出状态,最后报告实际结果。适合交付功能、修复问题或准备提交时使用,减少把预期成功当作已经成功的情况。

你需要准备:本次变更、需要证明的完成条件,以及项目的构建、测试或运行方式

一桉AI 整理 · 2026.10.31 更新 · 查看 GitHub 来源

粘贴到 Codex,它会先检查安装条件,再引导你使用。

Verification Before Completion 能帮你做什么?

  • 把结论对应到检查

    区分要证明的是构建、测试、功能行为还是修复效果,为每项选择能直接提供证据的方式。

  • 读取完整实际结果

    执行本次相关检查,查看退出状态、失败数量和输出,避免仅依据工具启动成功判断完成。

  • 说明验证覆盖范围

    将通过、失败、未运行和环境受限的项目分别记录,让接手者知道结论能支持到哪里。

什么时候适合用?

下面是用法示例,可换成你的材料和目标。

  • 修复后准备交付

    例如重新执行原问题的复现步骤和相关测试,确认修复是否生效,再整理尚未检查的影响。

  • 页面改完准备提交

    例如分别核对构建、路由和关键交互,把静态构建结果与实际浏览器行为分开报告。

怎么开始使用?

从材料到结果流程示意,非实测结果

本次变更与完成条件

准备这些材料完成前验证

本次变更、需要证明的完成条件,以及项目的构建、测试或运行方式

完成前验证流程

  1. 01

    确定完成条件和对应检查

  2. 02

    运行检查并读取完整结果

  3. 03

    记录证据与实际完成状态

准备什么,会得到什么?

准备的材料
本次变更、需要证明的完成条件,以及项目的构建、测试或运行方式
交付的结果
  • 对应完成条件的检查命令或操作、关键输出和实际状态。
  • 失败、未验证及环境限制清单,以及可复查的结论范围。

使用前要知道

需要完整 Superpowers 插件及可执行的项目环境。只能证明实际检查覆盖的内容;历史结果、部分检查或工具返回成功,不能直接代替本次变更的验证。

常见问题

构建通过就代表功能全部正常吗?

构建主要证明项目在该环境中能生成产物。登录、表单、数据保存等用户行为,还需要相应测试或实际操作才能支持结论。

缺少依赖无法执行检查怎么办?

应记录缺少什么、哪些检查没有运行和怎样补验。可以交付已有证据与待验步骤,但不能将未执行项目标成通过。

GitHub 与官方参考

依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。

  • verification-before-completion · SKILL.md ↗2026-10-31 核对
  • Superpowers · Codex 完整插件说明 ↗2026-10-31 核对
来源与使用条件
原始项目
obra/superpowers ↗
作者/维护者
obra / Superpowers
推荐者
数字生命卡兹克
介绍出处
查看推荐介绍 ↗
Skill 名称
verification-before-completion
Skill 目录
skills/verification-before-completion
仓库 Star
309,781 · 2026-10-31 核对,仅代表仓库关注度。
许可说明
MIT
使用条件
按上游 Codex 方案安装完整 Superpowers 插件。需要可执行相关构建、测试或运行检查的环境与依赖;验证命令由具体项目决定,缺少环境时应保留未验证状态。
注意事项
卡兹克推荐的是 Superpowers 整套开发流程,所展示的案例使用 Claude Code,不代表本单项已有 Codex 对照实测。当前 README 提供 Codex App/CLI 官方插件市场安装方案;本站仅核对来源,未运行实测。 检查成功只覆盖相应命令和场景;不能以历史结果、工具调用成功或部分检查代替本次变更的验证证据。
查看安装与使用提示词
请帮我准备并使用 Verification Before Completion Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。

【来源与目标】
原始仓库:https://github.com/obra/superpowers
所选目录:skills/verification-before-completion
参考分支:main
原始目录 frontmatter name:verification-before-completion
安装后的目标调用名:verification-before-completion
来源页面:https://github.com/obra/superpowers/tree/main/skills/verification-before-completion
安装路线核对日期:2026-11-01
verification-before-completion:当前源 SKILL.md:https://github.com/obra/superpowers/blob/main/skills/verification-before-completion/SKILL.md
Superpowers:当前 Codex App/CLI 插件安装:https://github.com/obra/superpowers/blob/main/README.md#codex-app
Superpowers:Codex 插件清单:https://github.com/obra/superpowers/blob/main/.codex-plugin/plugin.json

【先检查环境,再安装】
先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。
下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。
这是插件安装路线。按下列官方入口安装完整插件;仅复制某个 Skill 目录不能代替插件、连接器或 MCP 配置。若当前 Codex 必须由用户在界面完成插件安装或授权,请给出准确入口和最短步骤,完成后再检查所选 Skill。

所选 Skill 的具体安装步骤:
1. 先检查 Superpowers 是否已通过 Codex 插件安装;已安装则检查来源和版本,不叠加旧手工 Skills 目录。
2. Codex App 使用侧栏 Plugins,在 Coding 中找到 Superpowers,点击 + 并完成原生安装提示。
3. Codex CLI 使用 /plugins,搜索 superpowers,然后选择 Install Plugin。当前上游将 Codex 指向官方插件市场,不再使用旧 .codex/INSTALL.md。
4. 保留整插件、using-superpowers 引导、其他被调用 Skills 与所列资源;不要把单个 SKILL.md 的下载成功当作整套流程安装完成。
5. 检查 Skill 可发现状态;未出现时再重载或新聊天,涉及插件原生配置时按宿主提示处理。

必须保留的资源:
- 完整 Superpowers 插件(.codex-plugin/plugin.json、skills/ 及插件引导资源)
- skills/verification-before-completion/(整目录)

已知依赖:按上游 Codex 方案安装完整 Superpowers 插件。需要可执行相关构建、测试或运行检查的环境与依赖;验证命令由具体项目决定,缺少环境时应保留未验证状态。
原项目许可:MIT
特别条件:卡兹克推荐的是 Superpowers 整套开发流程,所展示的案例使用 Claude Code,不代表本单项已有 Codex 对照实测。当前 README 提供 Codex App/CLI 官方插件市场安装方案;本站仅核对来源,未运行实测。 检查成功只覆盖相应命令和场景;不能以历史结果、工具调用成功或部分检查代替本次变更的验证证据。
需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。

【安装后验收】
读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。
1. 核对插件来源 obra/superpowers、当前所选 Skill 的 name 与源文件一致,并能通过 Skill 选择器明确选中。
2. 读取验收要求和可用验证命令,确认哪些会创建文件、改数据库或调用外部服务;安装检查只做清单核对,不替任务运行。
Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。
分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。

【接着引导我使用】
请使用实际可用的 $verification-before-completion;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。
- 准备报告完成前,按实际修改选择构建、测试或人工验收方法,执行当前有效的验证并读取退出状态和完整关键输出。
- 只陈述此次检查覆盖到的结果;无法运行时列出缺失条件和待验证事项,不能引用昨天结果、下载日志或主观判断代替本次证据。

我想完成的任务:
在判断当前工作是否完成前,列出需要证明的完成条件,并选择能直接验证这些条件的项目命令或操作。实际执行相关检查,读取完整输出、退出状态和失败信息;报告哪些条件通过、哪些失败或未运行,并给出可复查的证据与尚未覆盖的范围。

需要我提供的材料:
本次变更、需要证明的完成条件,以及项目的构建、测试或运行方式

期望得到:
一份完成状态与验证记录,包含实际执行的检查、关键结果、失败或未验证项,以及结论的适用范围。

先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。

相关 Skill

  • Systematic Debugging系统化排查问题
  • Test Driven Development测试驱动开发
  • React Best PracticesReact 性能优化

复制到 Codex

浏览器暂未允许直接复制。点击下方文字,按 Ctrl+C(Mac 按 ⌘C)复制,再粘贴到 Codex。

三步开始使用

  1. 找到想做的事,点击「复制提示词」。
  2. 打开 Codex,把提示词粘贴进去并发送。
  3. 按它的提示提供文件或材料,继续完成任务。

按需安装就好,不用一次装完。部分 Skill 需要软件、账号或付费服务,Codex 会先检查使用条件。