AI Delivery Spec

Przekształca luźne żądanie funkcji w bramkowany, śledzalny brief wymagań lub PRD

Autor: franklinxkk · franklinxkk/ai-delivery-spec

Testowano · Działa ★ 8.4/10

AI Delivery Spec — Przekształca luźne żądanie funkcji w bramkowany, śledzalny brief wymagań lub PRD

Co robi ten skill

Jądro zarządzania wymaganiami dla Claude Code: kieruje żądanie do właściwego etapu (frame, explore, intake, clarify, specify, review, baseline, change, acceptance) i dostarcza najmniejszy kompletny artefakt dla tego etapu, ze stabilnymi identyfikatorami REQ/DEC/UNK i przypisanymi otwartymi pytaniami. Dołączone bramki Python sprawdzają następnie artefakt statycznie i odmawiają nazywania zgodności strukturalnej poprawnością biznesową. Uruchamia się na pisanie, zmienianie, przeglądanie lub akceptowanie wymagań, PRD i prototypów; wyraźnie wyklucza kodowanie, CI/CD i wdrożenie.

Raport z testu

Napisano ten sam brief 'add CSV export to the orders list' dwukrotnie i uruchomiono na obu własną bramkę Python umiejętności: wersja bez umiejętności wróciła jako BLOCKED, wersja kierowana umiejętnością wróciła jako REVIEW_COMPLETE_WITH_GAPS z zerem blokad i trzema otwartymi niewiadomymi, z których każda ma właściciela, etap blokujący i fallback. Luka w treści była większa niż luka w formacie — wersja umiejętności wychwyciła wstrzyknięcie formuły CSV, parzystość liczby wierszy w stosunku do licznika listy, oddzielne uprawnienia do eksportu i rekord audytu, z których żaden nie był wspomniany w zwykłym briefie, i przekształciła trzy 'otwarte pytania' bez właściciela w śledzone elementy. Bramka jest szczera co do swoich ograniczeń: każde uruchomienie drukuje NOT_PROVEN dla poprawności domenowej, zachowania w czasie wykonania i rzeczywistej akceptacji. Problem tkwi w języku — SKILL.md i README są w około dziewięćdziesięciu procentach chińskie, a części pomocy CLI również, więc zespoły anglojęzyczne czytają instrukcję przez tłumacza.

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

Instalacja

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

Komendy i przykładowe prompty

  • /ai-delivery-specPrzekształca luźne żądanie funkcji w bramkowany, śledzalny brief wymagań lub PRD

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

  • 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