mcpField
C
completion-evidence-discipline

completion-evidence-discipline

github.com/fudesign2008测试与质量653 次安装1 天前更新
代码仓库

关于 completion-evidence-discipline

completion-evidence-discipline 是供其他技能集成的内部共享技能,规范完成与验证声明。它要求使用当前轮次的新证据,未执行的检查必须标记为待处理。

主要功能

  1. 01要求提供当前轮次的验证证据
  2. 02将未运行的检查标为待处理
  3. 03区分已执行操作与待处理工作
  4. 04要求检查 UI 测试截图

适用场景

  1. 01准确报告测试和构建结果
  2. 02避免无证据地声称工作已通过
  3. 03记录仍需手动执行的验证
  4. 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 已通过。

必须遵循的行为

在准备声称以下任一事项时:测试已通过、类型检查/构建正常、验证已完成、错误已修复、已准备好合并/归档:

  1. 运行当前轮次中的相关命令/检查,或
  2. 标记为 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