AI Delivery Spec

Přemění volný požadavek na funkci na řízený, sledovatelný brief požadavků nebo PRD

od franklinxkk · franklinxkk/ai-delivery-spec

Otestováno · Funguje ★ 8.4/10

AI Delivery Spec — Přemění volný požadavek na funkci na řízený, sledovatelný brief požadavků nebo PRD

Co umí

Jádro pro správu požadavků pro Claude Code: směruje požadavek do správné fáze (frame, explore, intake, clarify, specify, review, baseline, change, acceptance) a dodává nejmenší kompletní artefakt pro tuto fázi, se stabilními REQ/DEC/UNK id a vlastněnými otevřenými otázkami. Přibalené Python brány pak staticky kontrolují artefakt a odmítají nazývat strukturální shodu obchodní správností. Spouští se na psaní, změnu, kontrolu nebo přijímání požadavků, PRD a prototypů; explicitně vylučuje kódování, CI/CD a nasazení.

Testovací report

Napsal jsem stejný brief 'add CSV export to the orders list' dvakrát a spustil vlastní Python bránu dovednosti na obou: verze bez dovednosti se vrátila BLOCKED, verze řízená dovedností se vrátila REVIEW_COMPLETE_WITH_GAPS s nulovými blokátory a třemi otevřenými neznámými, z nichž každá nese vlastníka, blokující fázi a záložní řešení. Obsahová mezera byla větší než formátová mezera – verze dovednosti zachytila CSV formula injection, paritu počtu řádků proti čítači seznamu, samostatné oprávnění k exportu a auditní záznam, nic z toho prostý brief nezmínil, a převedla tři 'open questions' bez vlastníka na sledované položky. Brána je upřímná ohledně svých vlastních limitů: každý běh tiskne NOT_PROVEN pro správnost domény, chování za běhu a skutečné přijetí. Háček je v jazyce – SKILL.md a README jsou zhruba z devadesáti procent čínské a části nápovědy CLI také, takže týmy pouze s angličtinou čtou manuál přes překladač.

Testováno: 2026-08-10 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /ai-delivery-specPřemění volný požadavek na funkci na řízený, sledovatelný brief požadavků nebo PRD

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

  • 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