sec-track - Funde nachverfolgbar machen
Phase "track". Vertrag: sec-scan/references/contract.md (Regel 4 Geheimnisse, Regel 8 Tickets in §6; Feld ticket in schemas/finding.schema.json). Nur Funde mit Status validated oder weiter - candidate wird nicht getrackt.
Ziel wählen
| Ziel |
Wann |
Werkzeug |
| Ticket im Ticketsystem des Nutzers |
Standard, privat, ohne Außenwirkung |
ticket_writer.py aus ticket-master |
| GitHub-Issue |
nur private Repos oder reine Härtungslücken ohne Exploit-Pfad |
gh issue create |
| Draft-Security-Advisory |
Schwachstelle in einem öffentlichen Repo |
gh api (Repository-Security-Advisories, Entwurf) |
Öffentliches Repo + ausnutzbarer Fund: nie ein öffentliches Issue - das wäre eine Offenlegung (Egress, Regel 6). Dort Draft-Advisory bzw. privates Ticket. Kein Linear, kein Jira.
Ablauf
- Auswahl: welche Funde, welches Ziel. Mehrere Funde nacheinander, nicht als Sammelticket, damit jede id eine eigene Referenz bekommt.
- Duplikatprüfung per Finding-id (
SEC-<12 hex>): finding.ticket bereits gesetzt? Ticket-Verzeichnisse nach der id durchsuchen; bei GitHub gh issue list --state all --search "<id>". Treffer: bestehende Referenz verwenden, nichts neu anlegen.
- Text entwerfen: id, Titel, Regel/CWE, Severity, Ort (
pfad:zeile), kurze Wirkung, Empfehlung, Verweis auf Patch-Datei falls vorhanden. Nie ein Geheimnis-Wert (Regel 4): nur Fundort. Keine Exploit-Details über das Nötige hinaus.
- Vorschau zeigen, Bestätigung abwarten. Erst danach anlegen - Ticket, Issue oder Advisory sind Außenwirkung bzw. nicht rückholbar.
- Anlegen:
- Ticket (IDs nie von Hand wählen, Regel 8):
python <ticket-master>/lib/ticket_writer.py --title "<SEC-id> <Titel>" --body "<Text>" --project <projekt> --priority <stufe>; die CLI gibt den Pfad der angelegten Ticketdatei aus. Die Doku im Modul nennt teils --urgency; die CLI selbst kennt --priority - vor Gebrauch --help lesen.
- Issue:
gh issue create --repo <owner/repo> --title ... --body-file <datei>.
- Advisory: Entwurf über die GitHub-REST-Schnittstelle für Repository-Security-Advisories (
gh api); genaue Felder vor Gebrauch in der GitHub-Doku prüfen (offen, hier nicht festgeschrieben). Entwurf lassen, nicht veröffentlichen.
- Referenz zurückschreiben:
finding.ticket = Ticket-Pfad/-id, owner/repo#nr oder Advisory-Link; dann python scripts/secfind.py validate findings.json coverage.json (Skript in sec-scan).
Changelog
0.1.0 (2026-10-31)
1---2name: sec-track3version: 0.1.04type: skill5author: Lukas Geiger + Claude6created: 2026-10-317updated: 2026-11-098description: "Verwenden, wenn bestätigte Sicherheitsfunde nachverfolgbar in Tickets, GitHub Issues oder Draft Security Advisories überführt werden sollen (z. B. 'Sicherheitsfund tracken', 'Security-Ticket für SEC-... anlegen', 'Draft Advisory erstellen', /sec-track). Erstellt Tickets ohne sensible Geheimnisse und verlinkt Tracking-IDs mit Fundakten. NICHT verwenden für öffentliche Offenlegungsberichte an Maintainer (dafür sec-writeup)."9standalone: true10anthropic_compatible: true11bach_compatible: false12bach_origin: false13category: dev14tags: [security, tickets, tracking, github, advisory]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-track22---232425<img src="banner.png" width="100%" alt="sec-track banner">2627# sec-track - Funde nachverfolgbar machen2829Phase "track". Vertrag: `sec-scan/references/contract.md` (Regel 4 Geheimnisse, Regel 8 Tickets in §6; Feld `ticket` in `schemas/finding.schema.json`). Nur Funde mit Status `validated` oder weiter - `candidate` wird nicht getrackt.3031## Ziel wählen3233| Ziel | Wann | Werkzeug |34|---|---|---|35| Ticket im Ticketsystem des Nutzers | Standard, privat, ohne Außenwirkung | `ticket_writer.py` aus ticket-master |36| GitHub-Issue | nur **private** Repos oder reine Härtungslücken ohne Exploit-Pfad | `gh issue create` |37| Draft-Security-Advisory | Schwachstelle in einem **öffentlichen** Repo | `gh api` (Repository-Security-Advisories, Entwurf) |3839**Öffentliches Repo + ausnutzbarer Fund: nie ein öffentliches Issue** - das wäre eine Offenlegung (Egress, Regel 6). Dort Draft-Advisory bzw. privates Ticket. Kein Linear, kein Jira.4041## Ablauf42431. **Auswahl:** welche Funde, welches Ziel. Mehrere Funde nacheinander, nicht als Sammelticket, damit jede id eine eigene Referenz bekommt.442. **Duplikatprüfung per Finding-id** (`SEC-<12 hex>`): `finding.ticket` bereits gesetzt? Ticket-Verzeichnisse nach der id durchsuchen; bei GitHub `gh issue list --state all --search "<id>"`. Treffer: bestehende Referenz verwenden, nichts neu anlegen.453. **Text entwerfen:** id, Titel, Regel/CWE, Severity, Ort (`pfad:zeile`), kurze Wirkung, Empfehlung, Verweis auf Patch-Datei falls vorhanden. **Nie ein Geheimnis-Wert** (Regel 4): nur Fundort. Keine Exploit-Details über das Nötige hinaus.464. **Vorschau zeigen, Bestätigung abwarten.** Erst danach anlegen - Ticket, Issue oder Advisory sind Außenwirkung bzw. nicht rückholbar.475. **Anlegen:**48 - Ticket (IDs nie von Hand wählen, Regel 8): `python <ticket-master>/lib/ticket_writer.py --title "<SEC-id> <Titel>" --body "<Text>" --project <projekt> --priority <stufe>`; die CLI gibt den Pfad der angelegten Ticketdatei aus. Die Doku im Modul nennt teils `--urgency`; die CLI selbst kennt `--priority` - vor Gebrauch `--help` lesen.49 - Issue: `gh issue create --repo <owner/repo> --title ... --body-file <datei>`.50 - Advisory: Entwurf über die GitHub-REST-Schnittstelle für Repository-Security-Advisories (`gh api`); genaue Felder vor Gebrauch in der GitHub-Doku prüfen (offen, hier nicht festgeschrieben). Entwurf lassen, nicht veröffentlichen.516. **Referenz zurückschreiben:** `finding.ticket` = Ticket-Pfad/-id, `owner/repo#nr` oder Advisory-Link; dann `python scripts/secfind.py validate findings.json coverage.json` (Skript in `sec-scan`).5253## Changelog5455### 0.1.0 (2026-10-31)56- Erstfassung.