Pratique Gstack : flux de travail complet, de l'installation à l'exécution

##Présentation

Dans Concept, nous avons découvert le positionnement central de gstack - un ensemble de compétences basées sur les rôles qui transforme Claude Code en une équipe d'ingénierie virtuelle, et son positionnement différencié dans l'écosystème des outils de programmation d'IA par rapport à GSD, Superpowers, Ralph et d'autres solutions.

Cet article pratique se concentre sur comment utiliser : de l'installation et de la configuration à l'exécution du flux de travail complet, vous aidant à démarrer avec gstack en 30 minutes.

##Installation et configuration

Conditions préalables

• Claude Code est installé et disponible
• Git installé
• Bun v1.0+ installé (gstack est construit sur Bun)
• Les utilisateurs Windows ont également besoin de Node.js

Installation globale (recommandée, réalisée en 30 secondes)

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
cd ~/.claude/skills/gstack && ./setup

Le script d'installation fait trois choses :

1. Ajoutez les informations sur les compétences de gstack à votre fichier CLAUDE.md
2. Placez tous les fichiers de compétences dans le répertoire des compétences
3. Installez Playwright et le navigateur Chromium correspondant (pour /browse et /qa)

Installation au niveau du projet (partage en équipe)

Si vous souhaitez que les membres de l'équipe obtiennent automatiquement gstack après le clonage du référentiel :

cp -Rf ~/.claude/skills/gstack .claude/skills/gstack
rm -rf .claude/skills/gstack/.git
cd .claude/skills/gstack && ./setup

###Support multi-agents

gstack ne se limite pas à Claude Code et prend actuellement en charge 10 agents de programmation IA. ./setup détecte automatiquement les hôtes installés par défaut :

./setup --host codex      # OpenAI Codex CLI
./setup --host opencode   # OpenCode
./setup --host cursor     # Cursor
./setup --host factory    # Factory Droid
./setup --host slate      # Slate
./setup --host kiro       # Kiro
./setup --host hermes     # Hermes
./setup --host gbrain     # GBrain（修改版）
./setup --host openclaw   # OpenClaw（通过 ACP 派发 Claude Code 会话）

Le chemin d'installation des compétences de chaque hôte a la forme de ~/.<agent>/skills/gstack-*/ et n'interfère pas les uns avec les autres.

💡 Options supplémentaires pour les utilisateurs d'OpenClaw : En plus d'appeler via ACP, OpenClaw peut également installer directement 4 compétences méthodologiques natives (gstack-openclaw-office-hours, gstack-openclaw-ceo-review, gstack-openclaw-investigate, gstack-openclaw-retro) via ClawHub, qui peuvent être utilisées en conversation sans session Claude Code.

Mode équipe (partage en équipe + mises à jour automatiques, recommandé)

La v1.x introduit le mode équipe : chaque développeur installe gstack globalement, et l'entrepôt enregistre uniquement "nous utilisons gstack", et les mises à jour se produisent automatiquement :

(cd ~/.claude/skills/gstack && ./setup --team) && \
~/.claude/skills/gstack/bin/gstack-team-init required && \
git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"

Remplacer required par optional est un « rappel doux » plutôt qu’obligatoire. Chaque fois que vous démarrez Claude Code, il exécutera automatiquement une vérification de mise à jour (limitation une fois par heure, sûre et silencieuse en cas de panne du réseau). Il n’y a aucun fichier vendu dans l’entrepôt et il n’y a pas de dérive de version.

Mise à jour

cd ~/.claude/skills/gstack && git pull && ./setup

Ou utilisez /gstack-upgrade directement dans Claude Code.

Référence complète des commandes

Processus de sprint

Conception

Examen et sécurité

Tests et assurance qualité

Libération, exploitation et maintenance

Réviser et apprendre

Protection de sécurité

Intégration des outils

Standalone CLI（v0.19+）

En plus de la commande slash, gstack est également livré avec un ensemble de CLI autonomes (non exécutées dans la session Claude Code) :

Détails de configuration

CLAUDE.md Ajouter du contenu

Après l'installation, gstack ajoutera une liste et une brève description de toutes les compétences disponibles à votre CLAUDE.md. Cela permet à Claude Code de savoir quelles commandes sont disponibles.

Structure du répertoire de compétences

L'entrée principale est le ~/.claude/skills/gstack/SKILL.md de niveau supérieur, chaque sous-commande existe sous la forme d'un répertoire plat et le noyau est le fichier SKILL.md :

~/.claude/skills/gstack/
├── SKILL.md            # 主入口 skill
├── browse/             # 浏览器 daemon
├── qa/                 # QA 测试
├── review/             # 代码审查
├── ship/               # 发布流程
├── plan-ceo-review/    # CEO 审查
├── office-hours/       # 产品门诊
├── pair-agent/         # 跨 Agent 浏览器配对
├── open-gstack-browser/ # GStack Browser 启动器
├── setup-gbrain/       # GBrain 数据库一键上手
├── hosts/              # 10 个 host 配置（claude/codex/cursor/...）
├── bin/                # standalone CLI（gstack-model-benchmark 等）
└── ...                 # 当前 v1.x 共 50 个 skill 目录

Vous êtes libre de modifier n'importe quel SKILL.md pour personnaliser le comportement - c'est l'avantage du "fork and personnaliser".

Browse Daemon

Browse Daemon est une instance Chromium permanente. Configuration des clés :

• Port : 10 000 à 60 000 sélectionnés au hasard, prend en charge plus de 10 espaces de travail parallèles
• Sécurité : liez uniquement l'hôte local, utilisez l'authentification par jeton du porteur pour chaque session
• Cookie : utilisez /setup-browser-cookies pour importer depuis Chrome/Arc/Brave/Edge

Démonstration pratique du flux de travail

Ce qui suit montre un flux de travail Gstack typique. Les commandes et les résultats sont basés sur des cas réels dans la documentation et les vidéos.

💡 Remarque : Le résultat suivant est un exemple général compilé sur la base de recherches. Des captures d'écran de projets spécifiques seront ajoutées à l'avenir en fonction de la pratique réelle.

Étape 1 : Clinique de produits

> /office-hours

[YC Office Hours] 6 forcing questions:
1. Who specifically needs this?
2. What do they do today without it?
3. Why is this urgent right now?
4. How will you know it works?
5. What happens if you do nothing?
6. What is the smallest version you can ship?

→ Design doc generated

Ne vous précipitez pas pour écrire du code, laissez d'abord l'IA torturer vos idées du point de vue des heures de bureau de YC.

Étape 2 : Plan de révision multi-rôles

> /autoplan

[CEO Review] Finding the 10-star product...
[Design Review] Rating dimensions 0-10...
[Eng Review] Locking architecture + edge cases...

→ Fully reviewed plan ready

/autoplan exécute automatiquement trois séries d'examens PDG → Conception → Ingénierie pour produire un plan post-examen complet.

Étape 3 : Implémentation du codage

Coder normalement selon le plan approuvé. Vous pouvez utiliser la conversation standard Claude Code.

Étape 4 : Revue de code multi-experts

> /review

Dispatching 7 specialist reviewers...
- Testing coverage ✓
- Maintainability ✓
- Security: Found 1 issue (auto-fixing)
- Performance ✓
- Data migration ✓
- API contract ✓
- Red team: No vulnerabilities found

→ Review complete, 1 auto-fix applied

Étape 5 : Contrôle qualité du navigateur

> /qa

Opening headless browser...
Testing user flows:
- Login flow ✓
- Dashboard load ✓
- Form submission: Bug found → fixing → re-testing ✓
- Image upload ✓

→ 4 flows tested, 1 bug fixed, regression test generated

Étape 6 : Publier

> /ship

Syncing with main...
Running tests: 42 passed, 0 failed
Reviewing diff: 3 files changed
Updating VERSION: 1.2.0 → 1.3.0
Creating PR: "Add screenshot feature"

→ PR #47 created, ready for merge

Conseils pratiques et expérience communautaire

Suggestion de Garry Tan

ETHOS.md de gstack, trois principes fondamentaux :

1. Boil the Lake : l'IA rend l'exhaustivité presque gratuite : terminez toujours les choses et ne prenez pas de raccourcis
2. Rechercher avant de construire : recherchez d'abord, comprenez d'abord, puis commencez après une vérification des connaissances à trois niveaux
3. Souveraineté de l'utilisateur : recommandation de l'IA, c'est vous qui décidez. Même si les deux modèles d’IA sont d’accord, votre jugement prévaut

Le README de gstack commence par une citation de Karpathy - c'est aussi le point de départ pour Garry Tan lui-même pour expliquer pourquoi il veut construire gstack :

Expériences communautaires positives

• /office-hours pour les candidatures YC : plusieurs candidats S26 sur Reddit r/ycombinator ont signalé que l'utilisation des heures de bureau de gstack pour tester leurs documents de candidature est très efficace.
• L'audit de sécurité a révélé de réelles vulnérabilités : il y a eu un retour du CTO. /review a découvert une vulnérabilité XSS dont l'équipe n'était pas au courant.
• /browse Tests de navigateur réel : Reconnu par la communauté (y compris les critiques) comme une "contribution véritablement technique"

Pièges courants

• Demandes d'autorisation fréquentes : certains utilisateurs ont signalé que "les invites d'autorisation doivent être approuvées toutes les 30 secondes, ce qui rend impossible la mise en veille". Il est recommandé de configurer des règles d'approbation automatique appropriées dans les paramètres de Claude Code.
• Consommation élevée de jetons : les invites caractérisées augmenteront la consommation de contexte. Si vous êtes sensible aux coûts, vous pouvez utiliser de manière sélective les compétences dont vous avez le plus besoin
• Agent Loop : il existe des cas sur HN où des utilisateurs ont signalé que l'agent était resté bloqué dans une boucle de 70 minutes. Il est recommandé de définir des délais d'attente et des points de contrôle raisonnables
• Pas pour tout le monde : les développeurs expérimentés peuvent avoir l'impression que la plupart des compétences sont inutiles. gstack est plus adapté aux fondateurs indépendants et aux petites équipes plutôt qu'aux équipes dotées de processus d'ingénierie matures

Questions fréquemment posées et bonnes pratiques

**Q : Gstack et Superpowers peuvent-ils être utilisés en même temps ? **

Oui. Les deux se complètent : Superpowers est bon en matière de discipline des processus et d'assurance TDD, et Gstack est bon en matière de réflexion sur les produits et d'évaluations multi-rôles. De nombreuses équipes utilisent Superpowers pour la discipline de codage quotidienne et Gstack pour la planification des produits et l'assurance qualité.

**Q : Le jeton est-il cher ? **

Supérieur à Claude Code natif. L'invite de rôle de chaque compétence occupe la fenêtre contextuelle. Mais si votre temps vaut plus que les frais symboliques, c'est généralement une bonne affaire.

**Q : À quels types de projets convient-il ? **

Idéal pour le développement de produits complet – de l'idée au lancement. Si vous vous contentez de corriger des bugs ou de créer de petites fonctionnalités, le Claude Code natif suffit. La valeur de gstack est maximisée dans le « processus complet ».

**Q : Comment personnaliser la compétence ? **

Chaque compétence est un fichier SKILL.md. Modifiez-le directement :

1. Recherchez le répertoire de compétences : ~/.claude/skills/gstack/<skill-name>/
2. Modifiez SKILL.md
3. Réexécutez ./setup

La communauté recommande de bifurquer le référentiel et de le personnaliser au lieu de modifier directement l'installation globale.

Bonnes pratiques

1. D'abord /office-hours puis coder : prenez l'habitude de faire des cliniques de produits avant d'écrire un code
2. Faites bon usage de la vérification /browse : Ne vous contentez pas de regarder le code, laissez l'IA "voir" réellement votre application
3. Périodique /retro : Maintenir une visibilité sur la qualité du code et le rythme de travail
4. Adoption progressive : Pas besoin d'utiliser toutes les compétences en même temps. À partir de /office-hours + /review + /ship
5. Personnalisation de Fork : Si vous rencontrez une invite inappropriée, modifiez-la directement. C'est l'avantage de l'open source

Résumé

La valeur fondamentale de gstack ne réside pas dans la puissance d'une compétence spécifique, mais dans le fait qu'il fournit un mode de collaboration IA structuré - grâce au changement de rôle, vous pouvez obtenir différents types d'assistance IA à différentes étapes. Examinez d'abord l'orientation du produit du point de vue du PDG, puis examinez l'architecture avec la rigueur d'un responsable de l'ingénierie et enfin vérifiez les résultats avec le véritable navigateur de l'assurance qualité.

Ensuite, vous pouvez essayer de l'installer vous-même et démarrer votre premier projet gstack à partir de /office-hours.

Lecture approfondie :

• gstack Concepts — Comprendre les concepts fondamentaux de gstack et le positionnement écologique de l'outil
• GSD Practical — Un guide pratique d'une autre solution de programmation d'IA structurée
• Claude Skills Practical Chapter — Comprendre le mécanisme de création de Skill