AI Delivery Spec

Förvandlar en lös funktionsförfrågan till en grindad, spårbar kravspecifikation eller PRD

av franklinxkk · franklinxkk/ai-delivery-spec

Testad · Fungerar ★ 8.4/10

AI Delivery Spec — Förvandlar en lös funktionsförfrågan till en grindad, spårbar kravspecifikation eller PRD

Vad den gör

En kravhanteringskärna för Claude Code: den dirigerar en förfrågan till rätt steg (frame, explore, intake, clarify, specify, review, baseline, change, acceptance) och levererar det minsta kompletta artefakten för det steget, med stabila REQ/DEC/UNK ids och ägda öppna frågor. Paketerade Python-grindar kontrollerar sedan artefakten statiskt och vägrar att kalla strukturell överensstämmelse för affärsmässigt korrekt. Utlöses vid skrivning, ändring, granskning eller godkännande av krav, PRDs och prototyper; den exkluderar explicit kodning, CI/CD och distribution.

Testrapport

Skrev samma 'lägg till CSV export till orderlistan'-brief två gånger och körde färdighetens egen Python-grind på båda: versionen utan färdighet kom tillbaka BLOCKED, den färdighetsstyrda kom tillbaka REVIEW_COMPLETE_WITH_GAPS med noll blockerare och tre öppna okända som var och en har en ägare, ett blockerande steg och en fallback. Innehållsgapet var större än formatgapet — färdighetsversionen fångade CSV formula injection, radantalsparitet mot listräknaren, en separat exportbehörighet och en revisionspost, inget av detta nämndes i den vanliga briefen, och den konverterade tre ägarlösa 'öppna frågor' till spårade objekt. Grinden är ärlig om sina egna begränsningar: varje körning skriver ut NOT_PROVEN för domänkorrekthet, runtime-beteende och verklig acceptans. Haken är språket — SKILL.md och README är ungefär nittio procent Chinese, och delar av CLI-hjälpen är det också, så English-only team läser manualen via en översättare.

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

Installation

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

Kommandon och exempelprompter

  • /ai-delivery-specFörvandlar en lös funktionsförfrågan till en grindad, spårbar kravspecifikation eller PRD

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • 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