name: issue-project-init description: Richtet das GitHub Issue-Tracking für ein Repository ein: Standard-Labels, ein Projects v2 Board mit Status/Reach/Impact/Confidence/Effort/RICE-Feldern (neu oder von einem Referenz-Board kopiert), Verknüpfung mit dem Repo und Dokumentation des Workflows. Verwenden beim Einrichten von Issues und eines Projekts für ein neues Repo oder wenn Labels/Felder abweichen.
Issues und Projekt für ein Repository initialisieren
Richtet die Konventionen ein, die die anderen issue-*-Skills voraussetzen. Alles hier schreibt auf GitHub (Labels, ein Projekt, eine Repo-Verknüpfung): Gib an, was erstellt wird, und hole die Zustimmung des Benutzers ein. Nichts wird per Git gepusht.
Voraussetzungen: gh auth status zeigt die Bereiche repo und project (sonst gh auth refresh -s project); jq ist installiert.
1. Prüfen (nur lesen)
REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner); OWNER=${REPO%%/*}
gh label list --repo "$REPO" --limit 100
gh project list --owner "$OWNER"
2. Labels
Erstelle die folgenden Standard-Labels (name|description|colour). Füge die eigenen Komponenten-Labels des Repos hinzu (Standard backend, frontend; entfernen oder hinzufügen, wie es passt). Lasse die GitHub-Standard-Labels (enhancement, documentation, ...) in Ruhe, es sei denn, es wird darum gebeten.
while IFS='|' read -r n d c; do
gh label create "$n" --repo "$REPO" --description "$d" --color "$c" --force
done <<'EOF'
bug|Etwas funktioniert nicht|d73a4a
feature|Neue benutzerseitige Fähigkeit|a2eeef
tech-debt|Nachverfolgte technische Schuld|fbca04
epic|Mehrere Issues umfassender Aufwand|5319e7
backend|Backend / Dienste|0e8a16
frontend|Frontend / Web-App|1d76db
performance|Leistung|fef2c0
security|Sicherheit|d93f0b
testing|Tests / CI / E2E|c5def5
privacy|Datenschutz / DSGVO|bfdadc
ai|Durch einen KI-Agenten ohne menschliches Eingreifen bearbeitbar|7057ff
needs-context|KI-bearbeitbar, sobald eine kurze Prüfung oder Entscheidung beantwortet ist (trägt auch ai)|fbca04
needs-human|Erfordert ein Gerät, store/legal/owner-Entscheidung, externen Zugriff oder eine Roadmap-Wahl|d93f0b
wontfix|Wird nicht bearbeitet|ffffff
EOF
gh label list --repo "$REPO" # Erstellen ist bei Erfolg still: überprüfen
3. Board
A. Ein Referenz-Board kopieren (Felder und Ansichten, nicht Items):
gh project copy <source-number> --source-owner <owner> --target-owner "$OWNER" --title "<Repo-Name>"
B. Von Grund auf neu:
gh project create --owner "$OWNER" --title "<Repo-Name>" --format json -q '.number' # als $N notieren
for f in Reach Impact "Confidence (%)" "Effort (days)" RICE; do
gh project field-create "$N" --owner "$OWNER" --name "$f" --data-type NUMBER
done
Ein neues Board hat bereits ein Status-Feld mit Todo, In Progress, Done; das ist ausreichend (eine Defer-Option kann in der Board-Oberfläche hinzugefügt werden).
Anschließend verknüpfen und überprüfen:
gh project link "$N" --owner "$OWNER" --repo "$REPO"
# dann folge "IDs zuerst auflösen" in issue-project-fields: es muss das Board und alle Felder finden
4. Im Repository dokumentieren
Füge diesen Abschnitt in die Agentenanweisungen des Repos (AGENTS.md, CLAUDE.md oder beide) ein, fülle die <...>-Platzhalter aus (Repo, Board-URL und die in Schritt 2 erstellten Komponenten-Labels; wenn die Skills aus einem Plugin stammen, dies angeben und das Plugin nennen). Commit auf einem Branch, nicht auf dem Standard-Branch.
## Arbeitsverfolgung (GitHub Issues)
Der Backlog befindet sich in **GitHub Issues** (`<owner/repo>`), verfolgt im Projekt **<Board-Titel>** (<Board-URL>). Das Issue ist die Quelle der Wahrheit für Kontext *und* Status; auf Arbeit per Issue-Nummer (`#123`) und Labels verweisen. Workflow-Skills: `issue-search`, `issue-file`, `issue-start`, `issue-pr-refs`, `issue-close-out`, `issue-project-fields`, `issue-score`, `issue-link`, `issue-plan-doc`, `issue-file-found`, `issue-audit-scores`, `issue-project-init` (<woher sie kommen>).
### Labels
| Gruppe | Labels | Regel |
|---|---|---|
| Typ | `bug`, `feature`, `tech-debt`, `epic` | Genau eines pro Issue |
| Komponente | <z.B. `backend`, `frontend`> | So viele wie zutreffend |
| Thema | `performance`, `security`, `testing`, `privacy` | Optional |
| Agenten-Routing | `ai`, `needs-context`, `needs-human` | Optional. `ai` = ein Agent kann es unbeaufsichtigt erledigen; `needs-context` = ein Agent kann es, sobald eine kurze Frage beantwortet ist (trägt auch `ai`); `needs-human` = benötigt ein Gerät, externen Zugriff oder eine Entscheidung des Verantwortlichen |
### Projektfelder
| Feld | Werte | Hinweise |
|---|---|---|
| Status | Todo / In Progress / Done | Nur vom orchestrierenden Agenten gesetzt |
| Reach | 1–5 | Wie viele Benutzer es berührt |
| Impact | 0,5–3 | Größe der Auswirkung |
| Confidence (%) | ganze Prozent, z.B. `70` | |
| Effort (days) | Zahl | |
| RICE | `(Reach × Impact × Confidence) / Effort` | Auch im Body als `**Score:** RICE x = (R × I × C%) / Ed` geschrieben, damit das Issue eigenständig lesbar ist |
### Issue-Body und Workflow
**Issue-Body** enthält den vollständigen Datensatz: Beschreibung, aktueller Zustand, was getan werden muss, warum es wichtig ist, zugehörige Dateien, Aufwandsschätzung. Verknüpfe verwandte Arbeit mit `#n`; drücke Reihenfolge mit „blocked by“ aus (Body-Text und die dependencies API, siehe `issue-link`). Große Arbeit ist ein `epic`, dessen Plan im Issue-Body lebt und dessen Teile Sub-Issues sind.
- **Vor dem Start:** zuerst suchen (`issue-search`); wiederverwenden oder erweitern, anstatt Duplikate anzulegen.
- **Während der Arbeit:** das Item auf In Progress setzen und zuweisen (`issue-start`); Branchnamen enthalten die Issue-Nummer (`feat/123-short-desc`). Bugs und technische Schuld beginnen mit einem fehlschlagenden Test. Nicht zusammenhängende Funde als neue Issues erfassen, anstatt den Umfang zu erweitern (`issue-file-found`).
- **Abschluss:** jeder PR referenziert seine Issues (`Closes #n` pro Issue, `Part of #n` für das Epic; `issue-pr-refs`); nach dem Merge Status = Done setzen und zugehörige Issues aktualisieren (`issue-close-out`).
- `gh` benötigt den Bereich `project` (`gh auth refresh -s project`). Nur der orchestrierende Agent ändert Issue/Projekt-Status; delegierte Sub-Agenten erstellen, bearbeiten oder schließen keine Issues.
5. Optional: ein Epic anlegen
issue-file (Typ epic) → issue-plan-doc → pro Teil issue-file + issue-link + issue-project-fields + issue-score.
Fallstricke
gh label create,gh project copy|link|item-editsind bei Erfolg still: immer überprüfen.- Ein kopiertes Board ist anfangs leer;
item-addist idempotent. - REST-Aufrufe für Sub-Issues und Abhängigkeiten verwenden die numerische Datenbank-ID des Issues (siehe
issue-link). - Confidence ist eine ganze Prozentzahl (
70); IDs unterscheiden sich pro Board, daher immer neu ermitteln (issue-project-fields).