关于 completion-evidence-discipline
completion-evidence-discipline 是供其他技能集成的内部共享技能,规范完成与验证声明。它要求使用当前轮次的新证据,未执行的检查必须标记为待处理。
主要功能
- 01要求提供当前轮次的验证证据
- 02将未运行的检查标为待处理
- 03区分已执行操作与待处理工作
- 04要求检查 UI 测试截图
适用场景
- 01准确报告测试和构建结果
- 02避免无证据地声称工作已通过
- 03记录仍需手动执行的验证
- 04检查 UI 测试生成的截图
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fudesign2008/ open-skills --skill completion-evidence-discipline安装后在 Claude Code 中输入/completion-evidence-discipline确认已加载。
详细介绍
完成证据规范
内部共享技能。关于完成和验证声明所需的最新证据门槛的唯一事实来源。宿主通过
dependencies(直接或经由staged-review-flow)声明此技能;如果缺失则中止,不会静默回退。**名称说明:**此技能有意不命名为
verification-before-completion(该名称由外部技能仓库保留)。请仅使用此名称。
铁律
没有来自当前轮次的最新证据,就不得声称已完成或已通过。
- 最新 = 由本助手在当前轮次中执行的命令、检查或观察到的工具结果所产生(或来自同一轮次附加的日志)。
- 非最新 = 之前轮次的记忆、“我们设计了一个测试”、仅有子 Agent 的成功文本,或假定 CI 已通过。
必须遵循的行为
在准备声称以下任一事项时:测试已通过、类型检查/构建正常、验证已完成、错误已修复、已准备好合并/归档:
- 运行当前轮次中的相关命令/检查,或
- 标记为 Pending,并准确说明仍需执行的手动操作——不得声称检查已通过。
如果检查打开了 UI,则此项最新证据还必须包含本轮保存的非空 png、jpg、jpeg 或 webp 文件的路径。没有此类文件的路径不支持通过声明。未打开 UI 的检查不需要图像。在打开 UI 的图像可作为检查依据之前,须在本轮查看已保存的图像。空白画面、纯黑画面或没有可读界面的图像都应保持 Pending,并注明仍需截图。如果图像显示的不是此项检查预期打开的屏幕,则应保持 Pending,并注明预期屏幕以及图像实际显示的内容。如果尚未检查图像,则该项应保持 Pending,并注明图像尚未检查。保留该文件。上述情况均不得视为符合要求的截图。
与 staged-review-flow 的验证诚实原则配合使用:
| 标签 | 含义 |
|---|---|
| Executed | 当前轮次中的命令/操作 + 简洁的输出摘要 |
| Pending | 用户(或之后的轮次)仍须执行的确切操作 |
禁止事项
- 当前轮次未运行验证命令,却报告“全部通过”/“已验证”
- 将设计好的场景或未经检查的断言当作已执行并通过
- 在此仓库中将此技能重命名或别名为
verification-before-completion
集成指南
- 宿主:在验证/收尾处添加一行指引——加载此技能;不要粘贴铁律或打开 UI 后检查截图的说明。
staged-review-flow:诚实规则必须与此门槛结合(Executed ⇒ 最新证据)。- 与
runtime-verification-discipline各自独立:此技能把关证据的时效性(是否在本轮执行);该技能把关验证的环境与执行者(属于哪个层级、由谁执行、是否充分)。通过声明必须同时满足两者。 - 优先设置
user-invocable: false;用户通过 PDCA 宿主使用此技能。
评论
支持 Markdown