issue-project-init

Richtet das GitHub Issue-Tracking für ein Repository ein: Standard-Labels, ein Projects v2 Board mit Status/Reach/Impact/Confidence/Effort/RICE-Feldern, Verknüpfung mit dem Repo und Dokumentation des Workflows.

Was ist issue-project-init?

Der Skill `issue-project-init` bootstrapt das Issue-Tracking für ein neues GitHub-Repository, indem er die standardisierten Labels und ein Projects v2 Board mit den Feldern Status, Reach, Impact, Confidence, Effort und RICE erstellt. Er kann ein Board entweder neu aufbauen oder von einem Referenz-Board kopieren (ohne Items). Anschließend verknüpft er das Board mit dem Repository und fügt eine detaillierte Workflow-Dokumentation in die Agentenanweisungen (AGENTS.md oder CLAUDE.md) ein, die alle verwendeten Felder, Labels und Abläufe beschreibt. Der Skill ist für die Plattformen Claude Code, Cursor und Codex geeignet und nutzt die GitHub CLI (`gh`) und `jq`. Er ist nützlich, wenn ein neues Repository eingerichtet wird oder wenn Labels und Felder durch manuelle Änderungen abweichen. Der Skill führt ausschließlich Schreiboperationen auf GitHub aus (Labels, Board, Verknüpfung) und kommuniziert alle Änderungen vorab an den Benutzer.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/marsv024/gh-issue-skills/tree/master/skills/issue-project-init

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation


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-edit sind bei Erfolg still: immer überprüfen.
  • Ein kopiertes Board ist anfangs leer; item-add ist 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).

Verwandte Skills