| name | fwd:issue-create |
| description | Interactief een GitHub issue opstellen volgens een vast 5-secties template (probleem, voorbeelden, bevindingen, potentiële oplossing, tests). Skill leest input uit een argument óf de huidige conversatie-context, detecteert bestaande repo-labels, vraagt om een assignee, en laat de gebruiker de complete draft per sectie reviewen voordat `gh issue create` wordt aangeroepen. Use when user wants to create a GitHub issue from a problem they are describing, runs `/fwd:issue-create`, says "maak een issue", or "create issue from context". |
| argument-hint | <vrije tekst beschrijving van probleem (optioneel — anders huidige context)> |
fwd:issue-create
Interactieve issue-creatie met een vast template en één review-ronde voordat de issue wordt opgevoerd.
Wat dit doet: input verzamelen → GitHub-metadata probet (labels, assignees) → een 5-secties draft bouwen → de gebruiker laat reviewen → rtk gh issue create aanroepen.
Wat dit NIET doet: issues automatisch opvoeren zonder bevestiging, de gebruiker spammen met popup-vragen per sectie, of bestaande issues sluiten/labelen.
Per-skill flow
1. Gather input
- Met argument (
/fwd:issue-create <vrije tekst>) → gebruik die tekst als basis voor het probleem.
- Zonder argument → gebruik de huidige conversatie-context: recente bug-discussies, foutmeldingen, code die je hebt gelezen, beslissingen die voorbij kwamen. Vat dat zelf samen tot één probleemstelling.
Als de context te dun is om iets zinnigs te schrijven (geen argument én geen relevante context in de laatste turns), vraag éénmaal aan de gebruiker om de probleemstelling in één zin te bevestigen voordat je verder bouwt.
2. GH meta probe
bash "${CLAUDE_SKILL_DIR}/scripts/probe-meta.sh"
Stdout is een JSON-blob:
{"labels":[{"name":"bug","description":"..."}, ...],"assignees":["alice","bas",...]}
Bij non-zero exit (gh niet geauthenticeerd, niet in een git-repo, geen remote): rapporteer de stderr-regel en stop de skill. Probeer niet zelf gh auth login te draaien.
3. Draft + suggesties
Bouw een complete draft met deze 5 secties als ##-headers:
- Probleem — wat gaat er mis / wat ontbreekt er. 2-4 zinnen.
- Voorbeelden — concrete reproductie, scenarios, codefragmenten. Liefst direct kopieerbaar (codeblocks).
- Bevindingen — wat is al onderzocht. Verwijs naar relevante bestanden + regels als
path/to/file.ts:42.
- Potentiële oplossing — voorgestelde aanpak op hoofdlijnen. Niet de implementatie, wel de richting + één alternatief als dat zinnig is.
- Tests — concrete unit / integration / E2E tests die het gedrag moeten verifiëren. Eén of meer per niveau; benoem welke bestanden / suites geraakt worden.
Title: afgeleid uit het probleem, ≤72 chars, geen conventional-commit prefix (fix: / feat: etc.) — dat hoort op de commit, niet op de issue.
Labels: uit labels in de probe-output, kies 1-3 die inhoudelijk matchen op de draft (vergelijk met name + description). Toon de gekozen labels expliciet in de draft-header.
Assignee: default @me (de gebruiker, dus zichzelf). Toon de andere assignees uit de probe-output als alternatief in de draft-header, zodat de user kan zeggen "assign aan alice" tijdens review.
4. Review-ronde (één keer)
Toon de complete draft in dit format als één bericht:
## Concept-issue (review)
**Title:** <title>
**Labels:** <label1>, <label2>
**Assignee:** <login>
**Andere assignable users:** <login1>, <login2>, …
---
## 1. Probleem
<content>
## 2. Voorbeelden
<content>
## 3. Bevindingen
<content>
## 4. Potentiële oplossing
<content>
## 5. Tests
<content>
---
Reageer per sectie met **"ok"** of een wijzigingsinstructie. Schrijf **"annuleer"** om te stoppen zonder issue aan te maken.
Verwerk het antwoord:
- "ok" / geen wijzigingen → door naar stap 5.
- Wijzigingsinstructies (per sectie of voor title / labels / assignee) → pas aan en toon de aangepaste draft één keer terug. Vraag dan om finale bevestiging ("ok om op te voeren?"). Maximaal één regeneratie-ronde — daarna forceer ja/nee.
- "annuleer" / "stop" → stop zonder
gh issue create aan te roepen. Bevestig dat er niets is opgevoerd.
5. Issue opvoeren
Schrijf de body (de 5 secties) naar een tijdelijk bestand om quoting-problemen te vermijden:
BODY_FILE=$(mktemp)
cat > "$BODY_FILE" <<'EOF'
…
…
…
…
…
EOF
rtk gh issue create \
--title "<title>" \
--body-file "$BODY_FILE" \
--label "<label1>" --label "<label2>" \
--assignee "<login>"
rm -f "$BODY_FILE"
Stdout is de issue-URL — toon die aan de gebruiker. Als gh issue create faalt: toon de error en stop. Geen retry — laat de gebruiker eerst gh auth status / repo-permissies checken.
Boundaries
- Eén invocation = één issue. Geen batch-creatie.
- Geen popup-vragen per sectie. Review is inline vrije tekst (zie stap 4); AskUserQuestion is alleen toegestaan als de input écht te dun is in stap 1.
- Geen autonome run. Skill stopt altijd op user-confirmatie vóór
rtk gh issue create.
- Geen retry op create-failure. Toon de error, stop.
- Geen AI-attribution. De issue-body bevat geen "Generated with Claude Code" footer of
Co-Authored-By: Claude regel.
- Geen mutatie van bestaande issues. Skill maakt alleen aan; voor labels/comments/close zijn aparte tools nodig.
