thanhtung2693/specgate

Utilisation de SpecGate

Installation uniquement avec bootstrap

À utiliser lorsque specgate-project-setup n'est pas disponible après une installation skills.sh racine uniquement. Vérifiez command -v specgate (PowerShell : Get-Command specgate). Si absent, expliquez que skills.sh donne uniquement des instructions. Sur macOS, Linux ou WSL2, affichez ceci et attendez l'approbation explicite :

curl -fsSL https://raw.githubusercontent.com/thanhtung2693/specgate/main/scripts/install-cli.sh | sh

Windows natif : utilisez https://github.com/thanhtung2693/specgate/releases/latest ; n'inventez jamais PowerShell. Enregistrez specgate --version ensuite.

Ne faites confiance qu'à un verrou avec la source thanhtung2693/specgate et le chemin plugins/skills/specgate/SKILL.md, dans le projet skills-lock.json ou global ~/.agents/.skill-lock.json. Affichez sa commande correspondante et attendez l'approbation :

npx skills remove specgate -y
npx skills remove specgate -g -y

Ne modifiez ni ne supprimez jamais directement les fichiers skills.sh ou les verrous. Demandez l'IDE et la portée, puis prévisualisez, installez et vérifiez :

specgate plugins install --agent <codex|claude|cursor> [--project-local] --dry-run --no-input
specgate plugins install --agent <codex|claude|cursor> [--project-local] --no-input
specgate plugins doctor --agent <codex|claude|cursor> [--project-local] --json

En cas de propriété native d'un plugin, arrêtez-vous. Ne le désinstallez ni ne le désactivez sans approbation explicite séparée.

Exigez un redémarrage de l'IDE et arrêtez-vous avant l'initialisation. Continuez via specgate-project-setup après cela.

Achèvement : un plugin géré par CLI, doctor sain, redémarrage explicite.

Routage en une phase

Pour le travail de cycle de vie, choisissez exactement une phase avant d'agir :

• specgate-project-setup — initialiser, lier, installer, actualiser ou diagnostiquer SpecGate pour un dépôt.
• specgate-work-preparation — transformer une demande ou une spécification source en travail SpecGate approuvé.
• specgate-work-delivery — implémenter, reprendre, revoir ou retravailler un travail SpecGate approuvé.

Pour une question de travail en lecture seule ou de statut du cycle de vie avec une référence de travail, commencez par la lecture faisant autorité :

specgate change status "$WORK_REF" --json

Pour d'autres questions conceptuelles ou de dépannage, utilisez la plus petite lecture CLI pertinente. N'imposez pas de phase et ne modifiez pas d'enregistrements.

Avant une écriture ou une remise dépendante du mode, exécutez specgate doctor --json. Lisez data.mode ; ne déduisez jamais le mode de Docker, des URL ou de la disponibilité du navigateur. Signalez un résultat doctor infructueux au lieu de deviner.

Contrat d'exploitation

• La CLI specgate est la seule surface de lecture et d'écriture de l'état du produit. N'inspectez ni ne modifiez jamais directement SQLite SpecGate, Postgres, le stockage objet, les volumes de déploiement, ou .specgate/local. Les lectures de la source du dépôt restent autorisées.
• Les brouillons, explications, résumés et lectures du dépôt restent éphémères jusqu'à ce qu'une commande CLI explicite les persiste.
• Le framework auteur d'origine possède les documents source durables : leurs chemins, noms, cycle de vie et politique Git. SpecGate les instantané sur place. Il ne les déplace, copie, renomme, supprime, ne valide ni ne modifie les règles d'ignorance les concernant.
• Une passe de préparation n'est pas une approbation humaine. L'approbation, l'acceptation et les modifications demandées restent des décisions humaines. N'exécutez une commande de décision qu'après que l'humain a explicitement choisi et autorisé cette décision précise ; n'en déduisez jamais une.
• Un Pack de Contexte approuvé prime sur l'historique de discussion, le texte du tracker et la documentation obsolète du dépôt. N'étendez jamais silencieusement sa portée.
• Suivez les identifiants et versions exacts. artifact coverage <artifact-id> est une preuve de version exacte ; ne réduisez jamais les versions par nom de fonctionnalité.
• Suivez change status.data.next_actor et next_command. Lorsque le prochain acteur est humain, arrêtez-vous et remettez cette commande textuellement.
• Le mode local n'a pas d'URL d'interface utilisateur et n'appelle jamais specgate open. En mode Full, utilisez uniquement l'URL renvoyée par specgate open ... --print --json ; n'en construisez jamais une.

Pour la syntaxe des commandes, exécutez specgate <command> --help plutôt que de reconstruire les drapeaux de mémoire.