OpenSpecDéveloppement piloté par spécification pour les assistants IA

Notre philosophie :

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

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

Voir en action ​

Vous : /opsx:propose add-dark-mode
IA :  Créé openspec/changes/add-dark-mode/
     ✓ proposal.md — pourquoi nous faisons ça, 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 localStorage
     Toutes les tâches sont terminées !

Vous : /opsx:archive
IA :  Archivé dans openspec/changes/archive/2025-01-23-add-dark-mode/
     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

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

cd your-project
openspec init

Maintenant, dites à 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 avec openspec update.

Documentation ​

→ Démarrage : premiers pas
→ Flux de travail : combinaisons et modèles
→ Commandes : commandes slash et compétences
→ CLI : référence du terminal
→ Outils pris en charge : intégrations d'outils et chemins d'installation
→ Concepts : comment tout s'articule
→ Multi-langues : support multi-langues
→ Personnalisation : adaptez-le à vos besoins

Pourquoi OpenSpec ? ​

Les assistants de codage IA sont puissants mais imprévisibles lorsque les exigences ne vivent que dans l'historique des discussions. OpenSpec ajoute une couche de spécification légère pour que vous vous accordiez sur ce qu'il faut 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 que le code ne soit écrit
• Restez organisé — chaque modification obtient son propre dossier avec proposition, spécifications, conception et tâches
• Travaillez fluidement — mettez à jour n'importe quel artefact à tout moment, sans portes de phase rigides
• Utilisez vos outils — fonctionne avec plus de 20 assistants IA via des commandes slash

Comment nous comparons ​

vs. Spec Kit (GitHub) — Approfondi 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 invites vagues et des résultats imprévisibles. OpenSpec apporte de la prévisibilité sans la cérémonie.

Mise à jour d'OpenSpec ​

Mettre à niveau le paquet

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

Actualiser les instructions de l'agent

Exécutez ceci dans chaque projet pour régénérer les conseils de l'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 à raisonnement élevé. Nous recommandons Opus 4.5 et GPT 5.2 à la fois 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.

Contribution ​

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 refactorisations significatives ou les changements architecturaux, veuillez d'abord soumettre une proposition de modification 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 de 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 l'IA est le bienvenu — à condition qu'il ait été testé et vérifié. Les PR contenant du code généré par l'IA doivent mentionner l'agent de codage et le modèle utilisé (par exemple, "Généré avec Claude Code en 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