| name | report-bug |
| description | Report a bug as a GitHub Issue with description, reproduction steps, and initial analysis |
| disable-model-invocation | false |
| argument-hint | <bug description> |
Bug erfassen
Erfasse einen Bug als GitHub Issue mit Beschreibung, Reproduktionsschritten und erster Analyse.
Bug: $ARGUMENTS
Übersicht
Dieser Skill erstellt ein GitHub Issue für einen Bug — ohne ihn zu fixen. Zum Fixen nutze /fix-bug <issue-nummer>.
Schritt 1: Bug verstehen
- Falls
$ARGUMENTS eine Beschreibung enthält: Bug analysieren.
- Falls leer: User nach dem Bug fragen — was passiert, was sollte passieren, wo tritt es auf.
- Kontext sammeln:
- Welche Seite / welches Feature ist betroffen?
- Reproduktionsschritte (wenn bekannt)
- Fehlermeldung (Console, Server-Logs, UI)
Schritt 2: Schnelle Analyse
- Relevanten Code lesen — den betroffenen Bereich finden
- Docker Logs prüfen (falls Server-Bug):
docker compose logs readystackgo --tail 50 2>/dev/null | grep -i error
- Root Cause Vermutung formulieren (muss nicht 100% sicher sein)
Schritt 3: GitHub Issue erstellen (PFLICHT)
Ein Bug MUSS als GitHub Issue erfasst werden. Kein Bug ohne Issue.
gh issue create \
--title "bug: <Kurzbeschreibung>" \
--label "bug" \
--body "$(cat <<'EOF'
## Bug Description
<Was passiert?>
## Expected Behavior
<Was sollte passieren?>
## Steps to Reproduce
1. ...
2. ...
## Environment
- [ ] Production
- [ ] Local Dev (Docker)
- [ ] Both
## Analysis
<Erste Analyse: welcher Code/welche Komponente ist wahrscheinlich betroffen?>
<Vermutete Ursache?>
EOF
)"
Schritt 4: Zum Project Board hinzufügen (PFLICHT)
Jedes Bug-Issue MUSS auf dem Project Board sichtbar sein.
gh project item-add 6 --owner Wiesenwischer --url <ISSUE_URL>
PROJECT="PVT_kwHOAKdwzc4BR2Bg"
STATUS_FIELD="PVTSSF_lAHOAKdwzc4BR2Bgzg_jRfE"
BACKLOG_ID="56c4cbb9"
ITEM_ID=$(gh project item-list 6 --owner Wiesenwischer --format json --limit 200 --jq ".items[] | select(.content.number == <ISSUE_NUMBER>) | .id")
gh project item-edit --project-id $PROJECT --id "$ITEM_ID" --field-id $STATUS_FIELD --single-select-option-id $BACKLOG_ID
Board Status IDs (ReadyStackGo Roadmap):
| Status | ID |
|---|
| Backlog | 56c4cbb9 |
| Todo | af3283ef |
| In Progress | 9e4cff0c |
| Review | f25a5d7c |
| Done | c631b3e2 |
Schritt 5: Zusammenfassung
Zeige dem User:
- Issue-Nummer und Link
- Kurze Zusammenfassung des Bugs
- Vermutete Ursache
- Hinweis:
/fix-bug #NNN zum Fixen
Checkliste
Alle Punkte müssen abgehakt sein. Bei Fehler -> nochmal versuchen, nicht weitermachen.