Issue To Beads

Trasforma un issue GitHub in un albero di epic/task Beads archiviato con criteri di accettazione verificabili.

di jbdamask · jbdamask/john-claude-skills

Richiede configurazione ★ 7.6/10

Issue To Beads — Trasforma un issue GitHub in un albero di epic/task Beads archiviato con criteri di accettazione verificabili.

Cosa fa

Un workflow in 7 fasi che recupera un issue GitHub tramite gh, lo divide in branch/worktree, esegue un'esplorazione solo di pianificazione, quindi scompone il piano in un epic Beads (bd) con task/sotto-task che portano criteri di accettazione oggettivamente verificabili e link di dipendenza, raffinando fino a 5 passaggi prima della consegna. Si attiva su 'break down issue X', 'convert this to beads' o un URL di issue GitHub con l'intento di renderlo tracciabile — ma richiede assolutamente la CLI bd, un progetto Beads inizializzato e due skill sorelle (solo pianificazione, git-push-and-tag) dallo stesso plugin beads-planner.

Rapporto di test

La qualità della scomposizione è genuinamente buona — su un issue reale aperto ha correttamente retrocesso la sotto-funzionalità 'package tracking' a P2 non bloccante perché il testo dell'issue la definiva opzionale, e ha dato a ogni task un criterio di accettazione concreto pass/fail invece del 'test it works' del naive baseline. Ma la Fase 3 e la Fase 7 chiamano skill sorelle (beads-planner:plan-only, beads-planner:git-push-and-tag) che un'installazione standard 'cp -r issue-to-beads' in singola cartella lascerebbe indietro, e bd (Beads CLI) non è installato di default, quindi le fasi di archiviazione/consegna non hanno potuto essere eseguite realmente.

Testato il: 2026-07-15 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/jbdamask/john-claude-skills
cd john-claude-skills
mkdir -p ~/.claude/skills
cp -r plugins/beads-planner/skills/issue-to-beads ~/.claude/skills/issue-to-beads

Comandi e prompt di esempio

  • /issue-to-beadsTrasforma un issue GitHub in un albero di epic/task Beads archiviato con criteri di accettazione verificabili.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • break down this github issue into a beads epic with acceptance criteria
  • convert issue number four into trackable beads tasks with dependencies
  • turn this feature request into a filed epic with verifiable subtasks