OpenSpecDéveloppement Piloté par Spécification pour les Assistants IA

→ fluide, pas rigide
→ itératif, pas en cascade
→ simple, pas complexe
→ conçu pour les projets existants (brownfield), pas seulement les nouveaux (greenfield)
→ évolutif des projets personnels aux entreprises

Suivez @0xTab sur X pour les mises à jour · Rejoignez le Discord d'OpenSpec pour de l'aide et des questions.

Voir en action ​

Vous: /opsx:propose ajouter-mode-sombre
IA:   Créé openspec/changes/ajouter-mode-sombre/
      ✓ proposal.md — pourquoi nous le faisons, ce qui change
      ✓ specs/       — exigences et scénarios
      ✓ design.md    — approche technique
      ✓ tasks.md     — liste de contrôle d'implémentation
      Prêt pour l'implémentation !

Vous: /opsx:apply
IA:   Implémentation des tâches...
      ✓ 1.1 Ajouter le fournisseur de contexte de thème
      ✓ 1.2 Créer le composant de bascule
      ✓ 2.1 Ajouter les variables CSS
      ✓ 2.2 Connecter le localStorage
      Toutes les tâches terminées !

Vous: /opsx:archive
IA:   Archivé dans openspec/changes/archive/2025-01-23-ajouter-mode-sombre/
      Spécifications mises à jour. Prêt pour la prochaine fonctionnalité.

Démarrage Rapide ​

Nécessite Node.js 20.19.0 ou supérieur.

Installez OpenSpec globalement :

npm install -g @fission-ai/openspec@latest

Puis naviguez vers le répertoire de votre projet et initialisez :

cd votre-projet
openspec init

Dites maintenant à votre IA : /opsx:propose <ce-que-vous-voulez-construire>

Si vous souhaitez le flux de travail étendu (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard), sélectionnez-le avec openspec config profile et appliquez-le avec openspec update.

Documentation ​

→ Commencer : premiers pas
→ Flux de travail : combinaisons et modèles
→ Commandes : commandes slash et compétences
→ CLI : référence du terminal
→ Outils Supportés : intégrations d'outils et chemins d'installation
→ Concepts : comment tout s'assemble
→ Multi-Langues : support multi-langues
→ Personnalisation : adaptez-le à votre image

Pourquoi OpenSpec ? ​

Les assistants de codage IA sont puissants mais imprévisibles lorsque les exigences vivent uniquement dans l'historique des conversations. OpenSpec ajoute une couche de spécification légère pour que vous vous accordiez sur ce à construire avant qu'aucun code ne soit écrit.

• Accordez-vous avant de construire — l'humain et l'IA s'alignent sur les spécifications avant l'écriture du code
• Restez organisé — chaque changement obtient son propre dossier avec proposition, spécifications, conception et tâches
• Travaillez de manière fluide — mettez à jour n'importe quel artefact à tout moment, pas de portes de phase rigides
• Utilisez vos outils — fonctionne avec plus de 20 assistants IA via des commandes slash

Comment nous nous comparons ​

vs. Spec Kit (GitHub) — Complet mais lourd. Portes de phase rigides, beaucoup de Markdown, configuration Python. OpenSpec est plus léger et vous permet d'itérer librement.

vs. Kiro (AWS) — Puissant mais vous êtes enfermé dans leur IDE et limité aux modèles Claude. OpenSpec fonctionne avec les outils que vous utilisez déjà.

vs. rien — Le codage IA sans spécifications signifie des prompts vagues et des résultats imprévisibles. OpenSpec apporte de la prévisibilité sans la lourdeur.

Mettre à jour OpenSpec ​

Mettez à jour le package

npm install -g @fission-ai/openspec@latest

Rafraîchissez les instructions de l'agent

Exécutez ceci dans chaque projet pour régénérer les instructions IA et vous assurer que les dernières commandes slash sont actives :

openspec update

Notes d'utilisation ​

Sélection du modèle : OpenSpec fonctionne mieux avec des modèles à forte capacité de raisonnement. Nous recommandons Opus 4.5 et GPT 5.2 pour la planification et l'implémentation.

Hygiène du contexte : OpenSpec bénéficie d'une fenêtre de contexte propre. Effacez votre contexte avant de commencer l'implémentation et maintenez une bonne hygiène du contexte tout au long de votre session.

Contribuer ​

Petites corrections — Les corrections de bugs, les corrections de fautes de frappe et les améliorations mineures peuvent être soumises directement en tant que PR.

Changements plus importants — Pour les nouvelles fonctionnalités, les refontes importantes ou les changements architecturaux, veuillez d'abord soumettre une proposition de changement OpenSpec afin que nous puissions nous aligner sur l'intention et les objectifs avant le début de l'implémentation.

Lors de la rédaction des propositions, gardez à l'esprit la philosophie d'OpenSpec : nous servons une grande variété d'utilisateurs à travers différents agents de codage, modèles et cas d'utilisation. Les changements doivent bien fonctionner pour tout le monde.

Le code généré par IA est bienvenu — tant qu'il a été testé et vérifié. Les PR contenant du code généré par IA doivent mentionner l'agent de codage et le modèle utilisé (par ex., "Généré avec Claude Code utilisant claude-opus-4-5-20251101").

Développement ​

• Installer les dépendances : pnpm install
• Construire : pnpm run build
• Tester : pnpm test
• Développer la CLI localement : pnpm run dev ou pnpm run dev:cli
• Commits conventionnels (une ligne) : type(scope): subject

Autre ​

Licence ​

MIT