completion-evidence-discipline
Hard discipline for verification and completion claims: do NOT claim tests passed, a fix works, or a task is complete without fresh evidence from commands or checks run in the CURRENT turn; label unavailable checks as pending with the exact action required. Referenced by PDCA verification stages via staged-review-flow and host workflows. Triggers — 「完成须有证据」「验证证据纪律」「宣称完成前验证」「completion evidence」 / completion evidence discipline, fresh verification evidence. An opened-UI pass claim cites a non-empty image saved this turn. Do NOT use as a standalone product workflow.
How do I install this agent skill?
npx skills add https://github.com/fudesign2008/open-skills --skill completion-evidence-disciplineIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill establishes behavioral protocols for verifying task completion using current evidence and contains no executable code or security risks.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Completion Evidence Discipline
Internal shared skill. Single source of truth for fresh-evidence gates on completion and verification claims. Hosts declare it in
dependencies(directly or viastaged-review-flow) and abort if missing — no silent fallback.Name note: this skill is intentionally not named
verification-before-completion(reserved by an external skills repo). Use this name only.
Iron Law
NO COMPLETION OR PASS CLAIMS WITHOUT FRESH EVIDENCE FROM THE CURRENT TURN.
- Fresh = produced by a command, check, or observed tool result executed in this assistant turn (or an attached log from that same turn).
- Not fresh = prior-turn memory, “we designed a test”, subagent success text alone, or assumed green CI.
Required behavior
When about to claim any of: tests passed, typecheck/build OK, verification complete, bug fixed, ready to merge/archive:
- Run the relevant command/check in this turn, or
- Label Pending with the exact manual action still required — and do not say it passed.
When the check opened a UI, that fresh evidence includes a filesystem path to a non-empty png, jpg, jpeg, or webp saved this turn. A path with no such file does not support a pass claim. Checks that did not open a UI do not require an image. Before an opened-UI image supports the check, look at the saved image in this turn. A blank frame, a solid black frame, or an image with no readable interface stays pending and states that the capture is still required. A readable interface that is not the screen this check was supposed to open stays pending and states the expected screen and what the image shows. If the image was not inspected, the item stays pending and states that the image was not inspected. Keep the file. Do not treat any of those as the expected capture.
Compose with staged-review-flow verification honesty:
| Label | Meaning |
|---|---|
| Executed | Command/action + concise output summary from this turn |
| Pending | Exact action the user (or a later turn) must still run |
Forbidden
- Reporting “all green” / “verified” when no verifying command was run this turn
- Treating designed scenarios or unchecked assertions as executed passes
- Renaming or aliasing this skill to
verification-before-completioninside this repository
Integration guide
- Hosts: one-line pointer at verification / closeout — load this skill; do not paste the Iron Law or opened-UI screenshot inspection prose.
staged-review-flow: honesty rule MUST compose with this gate (Executed ⇒ fresh evidence).- Orthogonal to
runtime-verification-discipline: this skill gates evidence freshness (did you run it this turn); that skill gates verification environment and executor (which tier, who ran it, sufficient?). A pass claim must satisfy both. - Prefer
user-invocable: false; users reach it through PDCA hosts.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/fudesign2008/open-skills/completion-evidence-discipline">View completion-evidence-discipline on skillZs</a>