返回技能目录
人工审校其他

技能研究档案

verification-before-completion

来源声明

Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always

保留作者的英文原始描述。它表达设计意图,不代表已验证的实际效果。

Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always

研究摘要

人工审校

Skill Atlas editorial baseline · editorial-0.1.0

完成门槛型 Skill:在声明成功前,必须提供来自测试、构建或实际观察的新证据,用于减少无依据的完成声明。

审阅范围

对所收集的 SKILL.md 及辅助文本/代码进行确定性静态分析。机器辅助候选和发现等待人工编辑复核;不评估动态行为或效果。

可观察能力

  • 在声明完成前定义证据要求。
  • 把实现与验证分开。
  • 可用于代码、文档和界面任务。
  • 要求记录命令或观察结果。

限制与范围

  • 标准不清时证据要求可能被机械执行。
  • 对简单任务可能增加额外步骤。
  • 此处未验证智能体是否真的遵守。

适用读者

  • 容易夸大完成度的智能体和团队
  • 代码评审流程
  • 重视质量开发流程的团队

技能包含哪些内容

文件清单来自记录提交中的采集源码。路径与大小属于结构观察,不代表质量评价。

个文件
1
Markdown 文件
1
个脚本
0
个引用
0
大小
3.6 KB
结构复杂度
低

文件清单

路径类型字节
skills/verification-before-completion/SKILL.md指令3.6 KB

SKILL.md 前置元数据

{
  "name": "verification-before-completion",
  "description": "Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always"
}

对运行顺序的一种解读

此工作流根据源码材料重建表面顺序。除非明确记录受控评估,否则它属于暂定解读,而非真实运行轨迹。

  1. 01
    输入

    确认范围

    阅读触发条件,判断该 Skill 是否匹配当前任务。

  2. 02
  3. 03
    判断

    按需使用资源

    仅在文档流程需要时读取参考资料或运行脚本。

  4. 04
    输出

    交付并验证

    产出请求的交付物,并按来源描述的验收标准进行验证。

潜在风险面

静态发现用于提示安装前需要检查的位置,不能证明一项技能安全、恶意或有效。

静态审阅未发现问题

收集的文本未命中已配置的词法安全模式。这不是安全保证:混淆内容、仅含二进制的文件、动态行为和未知风险均未评估。

网络访问未观察到
文件写入未观察到
凭据使用未观察到
未记录具体的静态发现。

这并不证明风险不存在。请审阅源码并选择适当的运行环境。

编辑安全提示

从声明的流程看没有特殊运行时风险;仍应检查被引用的脚本。

上下文可能消耗在哪里

发现、激活与资源层具有不同含义。只有使用指定官方方法并记录模型的运行时,才显示精确数值。

精确 token 计数不可用

在管线使用明确模型执行官方精确计数之前,包括文件清单在内的所有 token 值均为 null。

未使用要求的官方方法记录 token 测量。本档案不会用字符数、文件大小或估计值替代。

受控评估

没有受控评估

该技能仅具备以上标明的证据。不声称任何任务成功率、token 效率、延迟或质量优势。

尚未测试

在源码可见的情况下使用

安装命令
git clone https://github.com/obra/superpowers.git cd superpowers # 将该 Skill 目录复制到以下任一位置: # ~/.claude/skills/verification-before-completion # .claude/skills/verification-before-completion
  1. 打开固定版本源码:https://github.com/obra/superpowers/tree/22f0b463e7a5e579904dd6211a520321035526f7/skills/verification-before-completion/SKILL.md。
  2. 审阅许可证、前置条件和所有捆绑资源。
  3. 将 Skill 安装到个人或项目级 Claude Code skills 目录。
  4. 重启或刷新 Claude Code,使该 Skill 可被发现。
验证安装

确认目标位置能够发现 SKILL.md,然后让 Claude Code 在测试任务中使用该 Skill。

前置条件

  • 标准不清时证据要求可能被机械执行。
  • 对简单任务可能增加额外步骤。
  • 此处未验证智能体是否真的遵守。

示例提示词

代表性任务

Use the verification-before-completion skill to help with this task. First summarize what the skill will do, then execute its documented workflow and show the source-linked evidence for each major decision.

使用前检查

Read the verification-before-completion skill files at https://github.com/obra/superpowers/tree/22f0b463e7a5e579904dd6211a520321035526f7/skills/verification-before-completion/SKILL.md. Explain its workflow, required tools, permissions and the main risks before I decide whether to install it.

附上限制条件的判断

优势

  • 直接针对无依据的成功声明。
  • 规则简单、可复用。

注意事项

  • 需要明确的验收标准。
  • 若不检查证据,容易流于形式。
研究结论

与明确的成功标准和真实验证步骤配合时,是值得采用的过程护栏。

从结构上保持可追溯

档案是对公开工件的限时阅读,而非背书。请通过来源链接检查确切的上游材料。

obrasuperpowersskills/verification-before-completion
来源类型
社区
提交
22f0b463e7a5e579904dd6211a520321035526f7
采集时间
2026年11月20日
最近核查
2026年11月20日
上游许可证
MIT
仓库星标
322,183
内容依据

仅对提供的文件进行确定性词法解析、YAML frontmatter 校验、文件清单、来源描述的工作流程提取和启发式暂定分类。由机器生成;无 LLM、执行、动态测试或人工编辑批准。