CommunityCodierung & Entwicklunggithub.com

Pound79/specproof

KI-geschriebene Tests ehrlich halten. KI entwirft Gherkin-Spezifikationen, eine deterministische SHA-256-Engine erkennt Abweichungen zwischen Spezifikation, Implementierung und Funktion in CI, und Menschen entscheiden. Agenten-Fähigkeiten für Codex und Claude Code, plus Playwright/Flutter-Gerüste.

Was ist specproof?

Pound79/specproof ist ein KI-Agenten-Skill, der die Zuverlässigkeit von automatisch generierten Tests erhöht, indem er einen deterministischen Mechanismus zur Erkennung von Abweichungen in CI-Pipelines einführt. Der Skill ermöglicht es KI-Agenten (Codex und Claude Code), Gherkin-Spezifikationen zu entwerfen, während eine SHA-256-Engine Änderungen zwischen Spezifikation, Implementierung und Funktionsverhalten verfolgt. Wenn Diskrepanzen auftreten – etwa durch Code-Updates oder geänderte Anforderungen – wird dies in CI gemeldet, sodass menschliche Entwickler bewusst entscheiden können, ob die Anpassungen korrekt sind oder nicht. Der Skill unterstützt außerdem Playwright- und Flutter-Gerüste für Web- und Mobile-Tests und ist darauf ausgelegt, sowohl mit CLI-Tools als auch über strukturierte Dateiformate zu interagieren. Dies reduziert das Risiko, dass KI-generierte Tests fehlerhaft werden, und fördert eine klare Trennung zwischen Spezifikation und Implementierung.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add Pound79/specproof

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht specproof?

KI-geschriebene Tests ehrlich halten. KI entwirft Gherkin-Spezifikationen, eine deterministische SHA-256-Engine erkennt Abweichungen zwischen Spezifikation, Implementierung und Funktion in CI, und Menschen entscheiden. Agenten-Fähigkeiten für Codex und Claude Code, plus Playwright/Flutter-Gerüste.

Funktionsweise

Specproof verwendet eine deterministische SHA-256-Engine, um den Zustand von Spezifikationen, Implementierungen und Funktionen zu hashen und so Änderungen zuverlässig zu erkennen. Wenn CI ausgeführt wird, vergleicht die Engine die Hashes und meldet jede Diskrepanz („Drift“). Der menschliche Entwickler kann dann entscheiden, ob die Abweichung beabsichtigt oder ein Fehler ist.

Installation

Fügen Sie die folgenden Umgebungsvariablen hinzu:

SPECPROOF_HASH=some_sha256_value

Optional:

SPECPROOF_MODE=strict|lenient

Verwendung

  1. Lassen Sie den KI-Agenten eine Gherkin-Spezifikation erstellen (specs/).
  2. Committen Sie die Spezifikation zusammen mit dem Code.
  3. CI berechnet den Hash der Spezifikation, der Implementierung und der Tests.
  4. Wenn sich der Hash ändert, schlägt der Build fehl, bis ein menschlicher Entwickler den Drift manuell bestätigt.

Beispiel-Gherkin

Funktionalität: Specproof
  Szenario: Erkennung von Drift
    Angenommen Specproof ist konfiguriert
    Wenn der Hash der Spezifikation sich ändert
    Dann meldet CI einen Drift

Unterstützte Plattformen

  • Claude Code: Über ~/.claude/skills/
  • Codex: Über Strukturerkennung

Lizenz

MIT

Verwandte Skills