Spec Kit écrit les documents.DotMD sert à les relire.

Ce qu’est GitHub Spec Kit

Spec Kit est la boîte à outils open source de GitHub pour le développement piloté par la spec. Il ne remplace pas votre agent. Il ajoute un outil en ligne de commande, specify, qui prépare votre projet, et une série de commandes que vous lancez dans le chat de votre agent. L’agent écrit ; Spec Kit lui donne les étapes et la structure.

Il prend en charge de nombreux agents, dont Claude Code, Codex CLI et Cursor. La liste complète se trouve sur la page des intégrations de Spec Kit.

Installer et initialiser

Il vous faut Python 3.11 ou plus récent et uv. Ensuite :

uv tool install specify-cli
specify init my-project --integration claude

L’option --integration prend la clé de votre agent : claude pour Claude Code, codex pour Codex CLI, cursor-agent pour Cursor. La page de Spec Kit donne la clé de tous les autres agents.

Les commandes, dans l’ordre

Vous les tapez dans le chat de l’agent, pas dans le terminal :

1. /speckit-constitution
2. /speckit-specify : écrit spec.md.
3. /speckit-plan : écrit plan.md.
4. /speckit-tasks : écrit tasks.md.
5. /speckit-implement : construit à partir des tâches.
6. /speckit-converge

L’écriture d’une commande varie selon l’agent : certains utilisent /speckit.specify, d’autres un tiret ou un $. Spec Kit explique les formes pour chaque agent dans ses notes sur l’appel des commandes.

Relire chaque étape dans DotMD

Spec Kit vous demande de relire chaque résultat avant de continuer. DotMD en fait une vraie relecture plutôt qu’un coup d’œil dans le terminal.

1. Ouvrir le projet

   Appuyez sur ⌘O et choisissez le dossier du projet. Les fichiers que Spec Kit écrit apparaissent dans la barre latérale dès leur création, mis en forme avec leurs titres, listes et tableaux.

2. Commenter la ligne exacte

   Lisez spec.md, sélectionnez une exigence fausse ou vague et appuyez sur ⌥⌘M. Écrivez ce qu’il faut changer. Les commentaires sont conservés par DotMD, pas dans le fichier.

3. Faire corriger par l’agent

   Dites à l’agent : « Passe en revue mes commentaires dans DotMD. » Il les lit via MCP et modifie le fichier. Chaque correction s’affiche à côté de son commentaire, l’ancien texte en rouge et le nouveau en vert. Acceptez ou rouvrez chacune.

4. Lancer la commande suivante seulement ensuite

   Quand la spec est juste, lancez /speckit-plan, puis recommencez pour le plan et les tâches. Une erreur repérée dans la spec coûte un commentaire ; repérée dans le code, elle coûte une reprise.

Vérifier tasks.md

La liste de tâches est une checklist Markdown, et DotMD affiche les listes de tâches avec leurs cases, pour voir d’un coup d’œil ce qui est fait et ce qui reste. Avant de lancer /speckit-implement, lisez les tâches comme l’agent le fera : dans l’ordre, chacune petite, aucune oubliée. Si vous avez lancé l’étape d’analyse de Spec Kit, traitez ses constats de la même façon : ouvrez-les dans DotMD et commentez ceux avec lesquels vous n’êtes pas d’accord.

Connecter l’agent à DotMD tient en une ligne ; les guides de Claude Code, de Codex et de Cursor la montrent.

Pourquoi relire chaque fichier

Spec Kit va vite : une commande, et un document entier apparaît. Cette vitesse est le risque. Si la spec contient une exigence fausse et que vous lancez la commande suivante sans lire, le plan et les tâches s’appuient dessus, et le code aussi. Lire spec.md attentivement une fois est la vérification la moins chère de tout le processus.

Questions sur Spec Kit

Plus de questions