sec-report
Letzte Phase der ellmos-Security-Familie. Vertrag: sec-scan/references/contract.md (Dateien 1, Severity 3, Coverage 5, Regeln 6). Das Skript importiert seclib aus dem Geschwisterordner sec-scan/scripts (im Repo skills/dev/ und im flachen Deployment ~/.claude/skills/; beide Ordner müssen nebeneinander liegen). Nur Standardbibliothek.
Aufruf
python scripts/render_report.py FINDINGS COVERAGE OUTDIR [--lang de|en]
Interpreter ausdrücklich aufrufen. OUTDIR ist das Scan-Verzeichnis; Lock-Prüfung vorher wie sec-scan Schritt 2 (fail-closed). Ergebnis: OUTDIR/report.md und OUTDIR/findings.sarif. Exitcodes: 0 = geschrieben, 1 = Eingabe unlesbar oder ungültig (nichts geschrieben), 2 = Aufruf falsch. Exitcode und Ausgabe zeigen.
Verhalten
- Validiert zuerst (
seclib.validate_findings). Fehler werden gelistet, es entsteht kein Bericht aus kaputten Daten. Erst die Ursache beheben (sec-scan, sec-validate), dann erneut rendern.
- report.md: Kopf (Ziel, Ref, Scanner) · Zusammenfassung · Warnungen · Funde nach Severity (critical bis info) mit Ort, Konfidenz, Status, Validierer, Beleg, Beschreibung, Auswirkung, Empfehlung, Ticket · abgelehnte Funde getrennt mit Grund · Coverage (gescannt mit Tiefe, nicht gescannt mit Grund, Grenzen).
- Ehrlichkeit (Vertrag 5, 6.9):
complete: false steht ganz oben als "PARTIELLER SCAN". Keine Funde plus unvollständige Abdeckung heißt "KEIN sauberes Ergebnis". Nur "Keine Funde bei vollständiger Abdeckung" darf wie ein sauberes Ergebnis lesen. Warnungen, etwa gleicher Anbieter bei Finder und Validierer, erscheinen im Bericht.
- findings.sarif: SARIF 2.1.0 aus
seclib.to_sarif; abgelehnte Funde bleiben als suppressions im Log. Direkt als Code-Scanning-Upload verwendbar. Hochladen ist eine Veröffentlichung nach außen und braucht den Nutzerauftrag.
Vor der Weitergabe
Bericht gegenlesen: keine Geheimniswerte (der Validator fängt nur gängige Muster; Vertrag 6.4), nur Fundorte. Berichte in Ticket-Systemen und Chats ebenfalls ohne Werte. Schwachstellen in öffentlichen Repos nicht als öffentliches Issue, sondern über privaten Meldeweg (SECURITY.md).
Test
python -m pytest tests -q -p no:cacheprovider im Skillordner (Bericht, SARIF, partieller Scan, Backtick-Evidenz, Negativfall ohne Ausgabe).
Changelog
0.1.0 (2026-10-31)
- Erstfassung mit
render_report.py: report.md und findings.sarif aus validierten Daten.
1---2name: sec-report3version: 0.1.04type: skill5author: Lukas Geiger + Claude6created: 2026-10-317updated: 2026-10-318description: "Erzeugt aus findings.json und coverage.json den Sicherheitsbericht report.md (nach Severity gruppiert, Coverage-Abschnitt mit Lücken, abgelehnte Funde getrennt, Zusammenfassung ohne Schönfärberei) und findings.sarif (SARIF 2.1.0) per Skript render_report.py. Nutzen bei 'Security-Bericht erstellen', 'Ergebnis des Scans zusammenfassen', 'SARIF exportieren', 'Bericht für Code Scanning'. Bricht bei ungültigen Daten ab, ein partieller Scan wird als partiell gemeldet. Neue Funde: sec-scan / sec-diff-scan. Prüfen: sec-validate. Einordnen: sec-triage."9standalone: true10anthropic_compatible: true11bach_compatible: false12bach_origin: false13category: dev14tags: [security, report, sarif, coverage, findings]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-report22---2324<img src="banner.png" width="100%" alt="sec-report banner">2526# sec-report2728Letzte Phase der ellmos-Security-Familie. Vertrag: `sec-scan/references/contract.md` (Dateien 1, Severity 3, Coverage 5, Regeln 6). Das Skript importiert `seclib` aus dem Geschwisterordner `sec-scan/scripts` (im Repo `skills/dev/` und im flachen Deployment `~/.claude/skills/`; beide Ordner müssen nebeneinander liegen). Nur Standardbibliothek.2930## Aufruf3132```33python scripts/render_report.py FINDINGS COVERAGE OUTDIR [--lang de|en]34```3536Interpreter ausdrücklich aufrufen. `OUTDIR` ist das Scan-Verzeichnis; Lock-Prüfung vorher wie `sec-scan` Schritt 2 (fail-closed). Ergebnis: `OUTDIR/report.md` und `OUTDIR/findings.sarif`. Exitcodes: 0 = geschrieben, 1 = Eingabe unlesbar oder ungültig (**nichts** geschrieben), 2 = Aufruf falsch. Exitcode und Ausgabe zeigen.3738## Verhalten3940- **Validiert zuerst** (`seclib.validate_findings`). Fehler werden gelistet, es entsteht kein Bericht aus kaputten Daten. Erst die Ursache beheben (`sec-scan`, `sec-validate`), dann erneut rendern.41- **report.md:** Kopf (Ziel, Ref, Scanner) · Zusammenfassung · Warnungen · Funde nach Severity (critical bis info) mit Ort, Konfidenz, Status, Validierer, Beleg, Beschreibung, Auswirkung, Empfehlung, Ticket · **abgelehnte Funde getrennt** mit Grund · Coverage (gescannt mit Tiefe, nicht gescannt mit Grund, Grenzen).42- **Ehrlichkeit (Vertrag 5, 6.9):** `complete: false` steht ganz oben als "PARTIELLER SCAN". Keine Funde plus unvollständige Abdeckung heißt "KEIN sauberes Ergebnis". Nur "Keine Funde bei vollständiger Abdeckung" darf wie ein sauberes Ergebnis lesen. Warnungen, etwa gleicher Anbieter bei Finder und Validierer, erscheinen im Bericht.43- **findings.sarif:** SARIF 2.1.0 aus `seclib.to_sarif`; abgelehnte Funde bleiben als `suppressions` im Log. Direkt als Code-Scanning-Upload verwendbar. Hochladen ist eine Veröffentlichung nach außen und braucht den Nutzerauftrag.4445## Vor der Weitergabe4647Bericht gegenlesen: keine Geheimniswerte (der Validator fängt nur gängige Muster; Vertrag 6.4), nur Fundorte. Berichte in Ticket-Systemen und Chats ebenfalls ohne Werte. Schwachstellen in öffentlichen Repos nicht als öffentliches Issue, sondern über privaten Meldeweg (SECURITY.md).4849## Test5051`python -m pytest tests -q -p no:cacheprovider` im Skillordner (Bericht, SARIF, partieller Scan, Backtick-Evidenz, Negativfall ohne Ausgabe).5253## Changelog5455### 0.1.0 (2026-10-31)5657- Erstfassung mit `render_report.py`: report.md und findings.sarif aus validierten Daten.