AI Delivery Spec

Trasforma una richiesta di funzionalità generica in un brief di requisiti o PRD tracciabile e controllato

di franklinxkk · franklinxkk/ai-delivery-spec

Promosso ★ 8.4/10

AI Delivery Spec — Trasforma una richiesta di funzionalità generica in un brief di requisiti o PRD tracciabile e controllato

Cosa fa

Un kernel di requirements-management per Claude Code: instrada una richiesta alla fase giusta (frame, explore, intake, clarify, specify, review, baseline, change, acceptance) e consegna l'artifact completo più piccolo per quella fase, con stable REQ/DEC/UNK ids e owned open questions. I Python gates inclusi controllano quindi l'artifact staticamente e si rifiutano di chiamare structural conformance business correctness. Si attiva sulla scrittura, modifica, revisione o accettazione di requirements, PRDs e prototypes; esclude esplicitamente coding, CI/CD e deployment.

Rapporto di test

Ho scritto lo stesso brief 'add CSV export to the orders list' due volte e ho eseguito il Python gate della skill su entrambi: la versione senza skill è tornata BLOCKED, quella guidata dalla skill è tornata REVIEW_COMPLETE_WITH_GAPS con zero blockers e tre open unknowns che portano ciascuno un owner, una blocking stage e un fallback. Il divario di contenuto era più grande del divario di formato — la versione della skill ha rilevato CSV formula injection, row-count parity rispetto al list counter, una separate export permission e un audit record, nessuno dei quali il brief semplice menzionava, e ha convertito tre 'open questions' senza proprietario in tracked items. Il gate è onesto sui propri limiti: ogni esecuzione stampa NOT_PROVEN per domain correctness, runtime behaviour e real acceptance. Il problema è la lingua — SKILL.md e il README sono circa il novanta percento in cinese, e anche parti della CLI help, quindi i team solo in inglese leggono il manuale tramite un traduttore.

Testato il: 2026-08-10 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/franklinxkk/ai-delivery-spec.git
mkdir -p ~/.claude/skills
cp -r ai-delivery-spec ~/.claude/skills/ai-delivery-spec

Comandi e prompt di esempio

  • /ai-delivery-specTrasforma una richiesta di funzionalità generica in un brief di requisiti o PRD tracciabile e controllato

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

  • Write a clarify-stage requirement brief for a CSV export button
  • Draft a PRD with REQ/DEC/UNK ids for this new feature request
  • Move this feature from intake to specify stage with open questions