CommunityCodierung & Entwicklunggithub.com

Zahlungs-Code-Review

Überprüft Java- oder Kotlin-Zahlungscode (Spring Boot, Kafka, JPA) auf Fehler, die Geld verlieren oder duplizieren – z. B. doppelte Belastungen durch fehlende Idempotenz-Schlüssel, Beträge in double/float, verlorene Events durch Dual-Writes, nicht-idempotente Consumer, Selbstfreigabe, fehlende Timeouts oder Kartendaten in Logs. Führt einen mitgelieferten Scanner aus, überprüft jedes Ergebnis im Code und geht dann eine manuelle Checkliste durch. Verwenden Sie dies beim Review eines Pull Requests oder eines Dienstes, der Zahlungen, Überweisungen, Rückerstattungen, Hauptbücher oder Salden erstellt, bewegt, genehmigt, bucht oder abgleicht.

Was ist Zahlungs-Code-Review?

Dieses Skill ermöglicht ein strukturiertes Code-Review speziell für Zahlungscode, um finanzielle Fehler zu finden, die echtes Geld kosten. Es kombiniert einen automatischen Scanner (Python 3.10+), der mit Heuristiken verdächtige Stellen findet, mit einer manuellen Überprüfung und einer vordefinierten Checkliste. Der Scanner erkennt Muster wie fehlende Idempotenz-Schlüssel, falsche Datentypen (double/float für Geldbeträge), fehlerhafte Konsumentenlogik oder fehlende Sicherheitsprüfungen. Jeder Fund muss durch Lesen des Codes validiert werden, um Fehlalarme auszuschließen. Das Skill unterstützt Plattformen wie Claude Code, Cursor und Codex und ist ideal für PR-Reviews von Spring Boot- und Kafka-basierten Zahlungsdiensten. Der Bericht priorisiert die höchste finanzielle Auswirkung und enthält eine Tabelle mit Schweregraden, konkreten Problemen und empfohlenen Fixes.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Vidhidesai12/payments-review-skill/tree/main/payments-code-review

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 Zahlungs-Code-Review?

Finden Sie die Fehler, die in Zahlungscode echtes Geld kosten, und erklären Sie jeden im Hinblick auf das Geld: Wer wird doppelt belastet, welche Buchung geht verloren, wer kann seine eigene Überweisung genehmigen.

Arbeitsablauf

  1. Abgrenzen. Finden Sie den Code, der Geld erstellt, bewegt, genehmigt, bucht oder abgleicht: Controller, Services, Listener, Entitäten, Migrationen. Notieren Sie den Stack (Spring Boot, Kafka, JPA, Kotlin).

  2. Scanner ausführen aus dem Ordner dieses Skills gegen das Projekt oder die geänderten Dateien:

    python scripts/scan.py <path-to-code>                # Markdown-Tabelle
    python scripts/scan.py <path-to-code> --format json  # für weitere Verarbeitung
    

    Benötigt Python 3.10+, sonst nichts. Es überspringt Testquellen, es sei denn, Sie übergeben --include-tests. Es liest Quelltext mit Heuristiken, daher ist seine Ausgabe eine Liste von Hinweisen.

  3. Jeden Fund durch Lesen des Codes überprüfen. Öffnen Sie für jeden Hinweis die Datei und bestätigen Sie:

    • Ein double namens amount, das wirklich ein Prozentsatz oder Verhältnis ist, ist kein PAY001.
    • Ein Consumer oder eine Genehmigungsmethode ist in Ordnung, wenn die Duplikats- oder Vier-Augen-Prüfung tiefer liegt, als der Scanner folgt (drei Aufrufe). Folgen Sie ihr und sagen Sie, wo sie ist.
    • Streichen Sie Fehlalarme und sagen Sie in einem Satz warum, damit der Leser dem Rest vertrauen kann.
  4. Manuelle Checkliste durchgehen in references/checklist.md. Sie erklärt jede Scanner-Regel mit einem schlechten und einem guten Beispiel und listet auf, was kein Scanner sehen kann: Wettlaufsituationen auf Salden, Idempotenz-Schlüsselbereich, Wiederholungs- und Timeout-Semantik, Zustandsmaschinen, Abgleich, Geld in Transit, Audit und Datenschutz. Gehen Sie nur so tief, wie es der zu prüfende Code erfordert.

  5. Bericht schreiben im untenstehenden Format. Beginnen Sie mit der höchsten finanziellen Auswirkung.

Berichtsformat

## Zahlungs-Review: <Dienst oder PR>

**Urteil:** <ein Satz: sicher zu mergen / vor Merge beheben / Neugestaltung erforderlich>

| # | Schweregrad | Wo | Problem | Finanzielle Auswirkung |
|---|---|---|---|---|
| 1 | Hoch | `TransferController.java:24` | Kein Idempotenz-Schlüssel bei POST /transfers | Ein Client-Wiederholungsversuch nach einem Timeout erzeugt eine zweite Überweisung |

### 1. <Titel>
**Warum es wichtig ist:** <was schiefgeht, konkret, mit einem Beispielbetrag>
**Fix:** <kleinste korrekte Änderung, mit einem kurzen Code-Snippet>

### Geprüft und in Ordnung
- <als korrekt überprüfte Dinge, mit Wo; hält das Review ehrlich>

### Nicht abgedeckt
- <was Sie nicht prüfen konnten, z.B. Datenbank-Constraints nicht in diesem Repo>

Regeln für das Review

  • Schweregrad hängt vom Geld ab. Hoch = Geld kann verloren, dupliziert oder von der falschen Person bewegt werden. Mittel = es kann unter Fehler- oder Lastbedingungen passieren. Niedrig = Hygiene.
  • Zitieren Sie die Zeile, mit Datei:Zeile, für jeden Fund. Melden Sie niemals einen Scanner-Hinweis, den Sie nicht bestätigt haben.
  • Bevorzugen Sie die kleinste sichere Korrektur, z.B. eine Unique-Constraint plus einen Idempotency-Key-Header, keine Neuschreibung. Wenn die richtige Korrektur strukturell ist (eine transaktionale Outbox), sagen Sie das deutlich.
  • Behaupten Sie keine Compliance. Dieses Review ist kein PCI-DSS- oder SOX-Audit; sagen Sie das, wenn Sie gefragt werden.
  • Prüfen Sie auch die Datenbank. Viele dieser Garantien gehören in Constraints (UNIQUE, CHECK, Trigger). Sehen Sie sich Migrationen (Flyway, Liquibase) an, wenn sie im Repository sind.

Verwandte Skills