sec-diff-scan
Wie sec-scan, aber der Scope ist eine Änderung. Vertrag, Dateiformate und Regeln: sec-scan/references/contract.md; Schemas und Validator in sec-scan/schemas/ und sec-scan/scripts/. Preflight (Eigentum, Lock-Prüfung, Egress, Kosten), Kandidaten-Aufbau (id per secfind.py id, Geheimnisse maskieren) und Validierung laufen wie in sec-scan > Ablauf. Hier nur die Unterschiede.
Scope auflösen
Eine der Quellen, immer mit dem exakten Vergleichspunkt:
- PR: Basis- und Head-Commit des PR (lokal
git diff <base>...<head>, oder PR per gh holen; Egress beachten).
- Commit(s) oder Branch:
git diff <base>...<branch>.
- Working-Tree:
git diff und git diff --staged plus ungetrackte Dateien.
findings.json > target.ref = Head-Commit (oder working-tree), target.scope = die Diff-Dateien. Ist der Diff leer, abbrechen und das melden.
Ablauf (statt sec-scan Schritte 3-5)
- Diff lesen, nicht nur Hunks: jede geänderte Datei im Zusammenhang der betroffenen Funktion.
- Kontext nachziehen: Aufrufer geänderter Funktionen (wer reicht Eingaben hinein?), Aufgerufene (wohin fließen die Daten?), Konfiguration und Tests, die Annahmen dokumentieren.
threatmodel.md nutzen, falls vorhanden; sonst nur die berührten Vertrauensgrenzen kurz selbst bestimmen (kein vollständiges Modell, dafür sec-threat-model).
- Prüffragen für Änderungen:
- Neue Einstiegspunkte oder neue Senken (Shell, SQL, Dateisystem, Deserialisierung, HTTP-Client)?
- Wurde eine Prüfung entfernt, abgeschwächt oder umgangen (Auth-Decorator, Validierung, Escaping, Rechteprüfung)?
- Regression bekannter Muster: derselbe Fehlertyp wie in früheren Funden oder im Rest des Repos (
rule aus vorhandenen findings.json, falls vorliegend).
- Neue Abhängigkeit oder geänderte Version in Manifest/Lockfile; Secrets oder Tokens in der Änderung; weitere Konfigurationsöffnung (CORS, Debug, Berechtigungen).
- Befund nur, wenn der Pfad die geänderte oder berührte Stelle tatsächlich erreicht. Vorbestehende Fehler im Kontext, die nicht mit der Änderung zusammenhängen, mit ihrer tatsächlichen Severity nach Vertrag 3 aufnehmen und in
description "vorbestehend, nicht durch diese Änderung eingeführt" vermerken (nicht auf info herabstufen) oder, wenn nicht geprüft, nur in coverage.limits nennen; sie sind nicht der Gegenstand des Diffs.
Coverage
coverage.json: scanned = die Diff-Dateien (Tiefe meist read) und die zusätzlich gelesenen Kontextdateien, notScanned = Diff-Dateien, die nicht gelesen wurden (binär, generiert, zu groß), mit Grund. limits nennt: "nur Änderung gescannt, Rest des Repos nicht". complete folgt der Regel aus Vertrag 5. Ein sauberer Diff-Scan ist keine Aussage über das Repo.
Abgrenzung
Kein Voll-Repo-Scan (sec-scan), keine Laufzeitprüfung (sec-validate), kein Fix. Ausgabe: findings.json, coverage.json, Exitcode von secfind.py validate.
Changelog
0.1.0 (2026-10-31)
- Erstfassung: Scope Änderung, Kontext-Nachzug, Regressionsfragen.
1---2name: sec-diff-scan3version: 0.1.04type: skill5author: Lukas Geiger + Claude6created: 2026-10-317updated: 2026-10-318description: "Security-Scan einer Änderung statt des ganzen Repos: PR, Commit, Branch-Diff oder Working-Tree-Patch. Prüft geänderte Zeilen samt Aufrufern und Aufgerufenen, sucht Regressionen bekannter Muster und schreibt Kandidaten in findings.json plus coverage.json mit Diff- und Kontextdateien. Nutzen bei 'Security-Review dieses PR', 'Diff auf Schwachstellen prüfen', 'vor dem Merge sicherheitlich ansehen', 'hat diese Änderung etwas aufgerissen'. Voll-Repo-Scan: sec-scan. Kandidaten widerlegen: sec-validate. Bericht: sec-report."9standalone: true10anthropic_compatible: true11bach_compatible: false12bach_origin: false13category: dev14tags: [security, scan, diff, pull-request, regression, review]15language: de16status: draft17visibility: public18dependencies: {'tools': [], 'services': [], 'protocols': [], 'python': []}19provenance: {'origin': 'custom', 'origin_path': null, 'origin_version': null, 'origin_repo': null, 'last_sync_from_origin': null, 'last_sync_to_origin': null, 'local_changes_since_sync': false}20metadata:21 source: https://skillmd.com/skills/ellmos-ai/sec-diff-scan22---2324<img src="banner.png" width="100%" alt="sec-diff-scan banner">2526# sec-diff-scan2728Wie `sec-scan`, aber der Scope ist eine **Änderung**. Vertrag, Dateiformate und Regeln: `sec-scan/references/contract.md`; Schemas und Validator in `sec-scan/schemas/` und `sec-scan/scripts/`. Preflight (Eigentum, Lock-Prüfung, Egress, Kosten), Kandidaten-Aufbau (`id` per `secfind.py id`, Geheimnisse maskieren) und Validierung laufen wie in `sec-scan` > Ablauf. Hier nur die Unterschiede.2930## Scope auflösen3132Eine der Quellen, immer mit dem exakten Vergleichspunkt:3334- PR: Basis- und Head-Commit des PR (lokal `git diff <base>...<head>`, oder PR per `gh` holen; Egress beachten).35- Commit(s) oder Branch: `git diff <base>...<branch>`.36- Working-Tree: `git diff` und `git diff --staged` plus ungetrackte Dateien.3738`findings.json` > `target.ref` = Head-Commit (oder `working-tree`), `target.scope` = die Diff-Dateien. Ist der Diff leer, abbrechen und das melden.3940## Ablauf (statt sec-scan Schritte 3-5)41421. **Diff lesen**, nicht nur Hunks: jede geänderte Datei im Zusammenhang der betroffenen Funktion.432. **Kontext nachziehen:** Aufrufer geänderter Funktionen (wer reicht Eingaben hinein?), Aufgerufene (wohin fließen die Daten?), Konfiguration und Tests, die Annahmen dokumentieren. `threatmodel.md` nutzen, falls vorhanden; sonst nur die berührten Vertrauensgrenzen kurz selbst bestimmen (kein vollständiges Modell, dafür `sec-threat-model`).443. **Prüffragen für Änderungen:**45 - Neue Einstiegspunkte oder neue Senken (Shell, SQL, Dateisystem, Deserialisierung, HTTP-Client)?46 - Wurde eine Prüfung entfernt, abgeschwächt oder umgangen (Auth-Decorator, Validierung, Escaping, Rechteprüfung)?47 - Regression bekannter Muster: derselbe Fehlertyp wie in früheren Funden oder im Rest des Repos (`rule` aus vorhandenen `findings.json`, falls vorliegend).48 - Neue Abhängigkeit oder geänderte Version in Manifest/Lockfile; Secrets oder Tokens in der Änderung; weitere Konfigurationsöffnung (CORS, Debug, Berechtigungen).494. **Befund nur, wenn der Pfad die geänderte oder berührte Stelle tatsächlich erreicht.** Vorbestehende Fehler im Kontext, die nicht mit der Änderung zusammenhängen, mit ihrer tatsächlichen Severity nach Vertrag 3 aufnehmen und in `description` "vorbestehend, nicht durch diese Änderung eingeführt" vermerken (nicht auf `info` herabstufen) oder, wenn nicht geprüft, nur in `coverage.limits` nennen; sie sind nicht der Gegenstand des Diffs.5051## Coverage5253`coverage.json`: `scanned` = die Diff-Dateien (Tiefe meist `read`) **und** die zusätzlich gelesenen Kontextdateien, `notScanned` = Diff-Dateien, die nicht gelesen wurden (binär, generiert, zu groß), mit Grund. `limits` nennt: "nur Änderung gescannt, Rest des Repos nicht". `complete` folgt der Regel aus Vertrag 5. Ein sauberer Diff-Scan ist keine Aussage über das Repo.5455## Abgrenzung5657Kein Voll-Repo-Scan (`sec-scan`), keine Laufzeitprüfung (`sec-validate`), kein Fix. Ausgabe: `findings.json`, `coverage.json`, Exitcode von `secfind.py validate`.5859## Changelog6061### 0.1.0 (2026-10-31)6263- Erstfassung: Scope Änderung, Kontext-Nachzug, Regressionsfragen.