AI Delivery Spec

Transforme une demande de fonctionnalité vague en un brief d'exigence ou PRD tracé et contrôlé

par franklinxkk · franklinxkk/ai-delivery-spec

Testé · Fonctionne ★ 8.4/10

AI Delivery Spec — Transforme une demande de fonctionnalité vague en un brief d'exigence ou PRD tracé et contrôlé

Ce que fait

Un noyau de gestion des exigences pour Claude Code : il achemine une demande vers la bonne étape (frame, explore, intake, clarify, specify, review, baseline, change, acceptance) et livre l'artefact complet le plus petit pour cette étape, avec des IDs REQ/DEC/UNK stables et des questions ouvertes attribuées. Les portes Python intégrées vérifient ensuite l'artefact statiquement et refusent d'appeler la conformité structurelle 'business correctness'. Se déclenche sur l'écriture, la modification, la révision ou l'acceptation des exigences, PRDs et prototypes ; elle exclut explicitement le codage, le CI/CD et le déploiement.

Rapport de test

J'ai écrit le même brief 'add CSV export to the orders list' deux fois et j'ai exécuté la propre porte Python de la skill sur les deux : la version sans skill est revenue BLOCKED, celle guidée par la skill est revenue REVIEW_COMPLETE_WITH_GAPS avec zéro bloqueur et trois inconnues ouvertes qui portent chacune un propriétaire, une étape de blocage et un fallback. L'écart de contenu était plus grand que l'écart de format — la version de la skill a détecté l'injection de formule CSV, la parité du nombre de lignes par rapport au compteur de liste, une permission d'exportation séparée et un enregistrement d'audit, dont aucun n'était mentionné dans le brief simple, et elle a converti trois 'questions ouvertes' sans propriétaire en éléments suivis. La porte est honnête quant à ses propres limites : chaque exécution imprime NOT_PROVEN pour la correction du domaine, le comportement d'exécution et l'acceptation réelle. Le problème est la langue — SKILL.md et le README sont environ quatre-vingt-dix pour cent chinois, et certaines parties de l'aide CLI le sont aussi, donc les équipes anglophones lisent le manuel via un traducteur.

Testé le: 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

Commandes et exemples de prompts

  • /ai-delivery-specTransforme une demande de fonctionnalité vague en un brief d'exigence ou PRD tracé et contrôlé

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • 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