prove-patch Skill
✓ OffiziellVerifiziert lokale Security-Patch-Commits mittels Scoped Case Execution und Three-Arm-Proof-Methodiken.
- GitHub Stars
- 8.136
- Dateien
- 1
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- CC-BY-SA-4.0
- Erlaubte Tools
- —
Was macht der prove-patch Skill?
Verifiziert lokale Security-Patch-Commits mittels Scoped Case Execution und Three-Arm-Proof-Methodiken.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den prove-patch skill
Die primäre Funktion dieses Skills ist die Verifizierung lokaler Security-Patch-Commits durch rigorose Scoped Case Execution und Three-Arm-Proof-Methodiken. Er wurde für Entwickler oder Security-Agents entwickelt, die unabhängig validieren müssen, dass ein spezifischer Patch-Commit eine Schwachstelle behebt, ohne Regressionen einzuführen. Der Prozess erfordert einen Baseline-Commit, den finalen Patch-Commit, einen definierten Repair Scope und ein unverändertes Reproduction Package.
Ein Agent sollte diesen Skill laden, wenn er einen formalen Proof für einen Fix generieren muss. Das Tool führt geplante Inputs sowohl auf dem sauberen Baseline- als auch auf dem gepatchten Tree unter Verwendung eines konsistenten Harness aus, um die Vergleichbarkeit der Ergebnisse zu gewährleisten. Es nutzt das Three-Arm-Helper-Script, um zu bestätigen, dass die Baseline fehlschlägt, der Patch besteht und ein vollständiger Baseline-Revert erneut fehlschlägt. Alle Ausführungsdaten, einschließlich stdout, stderr und Exit-Status, werden als Receipts gespeichert. Das finale Ergebnis ist eine strukturierte prove.json-Datei und ein Manifest, das validiert wird, um sicherzustellen, dass keine Evidence Gaps oder Findings existieren.
Was ein agent damit machen kann
- 1Einen Security-Fix validierenVerifiziere, dass ein spezifischer Commit eine Schwachstelle korrekt behebt, indem du Scoped Cases sowohl auf dem Baseline- als auch auf dem gepatchten Tree ausführst.
- 2Three-Arm-Proof-Verifizierung durchführenBestätige die Integrität eines Patches, indem du sicherstellst, dass die Baseline fehlschlägt, der Patch besteht und eine revertete Baseline erneut fehlschlägt.
- 3Projektspezifische Regressionstests ausführenFühre fokussierte Tests und Security-Checks auf dem gepatchten Code aus, um sicherzustellen, dass keine bestehende Funktionalität unterbrochen wird.
- 4Formale Proof-Manifeste generierenErstelle ein validiertes Protokoll des gesamten Proof-Versuchs, einschließlich aller Execution Receipts und Build-Identitäten.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den prove-patch Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den prove-patch Skill in Plugin installieren
/plugin marketplace add trailofbits/skills /plugin install patching-bugs@trailofbits
Den prove-patch Skill in Claude Code installieren
~/.claude/skills/prove-patch/SKILL.md
$ npx degit trailofbits/skills/plugins/patching-bugs/skills/prove-patch ~/.claude/skills/prove-patchDen prove-patch Skill in Claude Code (project) installieren
.claude/skills/prove-patch/SKILL.md
$ npx degit trailofbits/skills/plugins/patching-bugs/skills/prove-patch .claude/skills/prove-patchDen prove-patch Skill in Codex installieren
~/.agents/skills/prove-patch/SKILL.md
$ npx degit trailofbits/skills/plugins/patching-bugs/skills/prove-patch ~/.agents/skills/prove-patchDen prove-patch Skill in Gemini CLI installieren
~/.gemini/skills/prove-patch/SKILL.md
$ npx degit trailofbits/skills/plugins/patching-bugs/skills/prove-patch ~/.gemini/skills/prove-patchDen prove-patch Skill in Claude.ai installieren
npx degit trailofbits/skills/plugins/patching-bugs/skills/prove-patch prove-patch && zip -r prove-patch.zip prove-patch # claude.ai → Customize → Skills → + → Create skill → Upload a skill → prove-patch.zip
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Skill braucht 80 Punkte, keinen schweren Befund und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbartrailofbits/skills/plugins/patching-bugs/skills/prove-patch is public and reachablegithub.com/trailofbits/skills/tree/HEAD/plugins/patching-bug ↗Bestanden
- Open Source Lizenz (OSI)CC-BY-SA-4.0 is not OSI-approvedspdx.org/licenses/CC-BY-SA-4.0.html ↗Befund
- Commit oder Release im letzten JahrLast commit 2026-11-11github.com/trailofbits/skills/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/trailofbits/skills/blob/HEAD/plugins/patching-bug ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/trailofbits/skills/blob/HEAD/plugins/patching-bug ↗Bestanden
- SKILL.md folgt dem Agent-Skills-FormatValid name and description; says when to use it; 85 linesgithub.com/trailofbits/skills/blob/HEAD/plugins/patching-bug ↗Bestanden
SKILL.md
Auf GitHub ansehenProve Patch
Use the original baseline, final patch commit, declared repair_scope, and unchanged
reproduction package. Read the record contract. Do not
edit the patch or validate an uncommitted tree. Return failures for a new attempt.
Before target commands, follow its project guidance.
- Review the scoped cases and the patch without the patcher's conclusion. Execute
each planned input on clean baseline and patched trees with the same retained
harness source and command. The harness must print exactly one
PATCH_CASE {"input": ..., "actual": ...}from the exercised input and observed result, then printPATCH_REACHEDas its final stdout line immediately before the assertion. Representatives must fail on the baseline and pass on the patch. Valid controls must pass on both. Keep the baseline and patched stdout, stderr, exit status, elapsed time, command, and harness source underreceipts/. A timeout, setup failure, missing marker, mismatched input, or ambiguous observation is an evidence gap. A trustworthy patched failure is a finding. Never relabel a gap as a pass. - Run relevant project checks on the patch and retain the same raw receipts. Use baseline comparison for behavior checks and to attribute failed project checks; a passing patched suite may omit a baseline run. Include focused tests, regression and security checks where relevant. Record specific unproven limits; an empty list leaves the result inconclusive.
- Run the three-arm helper with the proof-type recipe in
the record contract,
reproduce.baseline_commit, and finalpatch_commit. Require the baseline to fail, patch to pass, and complete baseline revert to fail again. Requirereceipts/source.jsonto identify the pinned commits and the reverted tree to equal the original baseline tree. Require the type's build identity result. Retain all source-tree, build, and execution receipts. - Write
prove.jsonand a final manifest covering it and every receipt. Runuv run --no-project <script> manifest <prove-attempt-dir>and thenuv run --no-project <script> check <run-dir>with the validator. Independently inspect the native proof assessment and raw receipts before reporting a result. A complete proof has no findings or gaps. Return exact failures and receipt paths to the orchestrator.
{
"schema_version": 2,
"attempt": 1,
"failure_type": "runtime",
"baseline_commit": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"patch_commit": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"reverted": "pass",
"build_identity": "pass",
"hashes": {
"baseline": "1111111111111111111111111111111111111111111111111111111111111111",
"patched": "2222222222222222222222222222222222222222222222222222222222222222",
"reverted": "1111111111111111111111111111111111111111111111111111111111111111"
},
"reverted_hash_note": null,
"cases": [{
"check_id": "reported-input",
"argv": ["python", "receipts/case.py", "reported-input"],
"source": "receipts/case.py",
"runs": {
"baseline": {"exit_code": 1, "elapsed_ms": 15, "stdout": "receipts/case-base.stdout", "stderr": "receipts/case-base.stderr"},
"patched": {"exit_code": 0, "elapsed_ms": 14, "stdout": "receipts/case-patched.stdout", "stderr": "receipts/case-patched.stderr"}
}
}],
"project_checks": [{
"check_id": "focused-suite",
"kind": "suite",
"argv": ["pytest", "tests/test_upload.py"],
"baseline": null,
"patched": {"exit_code": 0, "elapsed_ms": 860, "stdout": "receipts/suite.stdout", "stderr": "receipts/suite.stderr"}
}],
"unproven": ["Inputs outside the declared boundary were not assessed."],
"agent": "prover-1"
}
For a bounded class, include at least two distinct failing representatives and a
valid control. The record must cover every planned case by unique check_id.
Use the same harness and command on both commits; do not reveal the side to the
harness or change expectations by side. Review the selected cases for relevance;
retained receipts establish only what those cases exercised.
Dateien in diesem Skill
1prove-patch Skill-Fragen
Wie installiere ich den prove-patch Skill in Claude Code?
Führe npx degit trailofbits/skills/plugins/patching-bugs/skills/prove-patch ~/.claude/skills/prove-patch aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den prove-patch Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Was ist erforderlich, um einen Three-Arm-Proof durchzuführen?
Der Prozess benötigt den Baseline-Commit, den finalen Patch-Commit und einen vollständigen Baseline-Revert, um sicherzustellen, dass der ursprüngliche Zustand wiederhergestellt wird.
Was gilt während des Verifizierungsprozesses als Evidence Gap?
Ein Evidence Gap tritt auf, wenn es einen Timeout, einen Setup-Fehler, einen fehlenden Marker, einen Input-Mismatch oder eine mehrdeutige Observation gibt.
Wie muss der Harness-Output für Scoped Cases formatiert sein?
Der Harness muss genau einen PATCH_CASE-Eintrag ausgeben, der den Input und das tatsächliche Ergebnis enthält, gefolgt von PATCH_REACHED unmittelbar vor der Assertion.