Práctica de gstack: flujo de trabajo completo desde la instalación hasta la ejecución

Introducción

En Concepto, aprendimos sobre el posicionamiento central de gstack, un conjunto de habilidades basado en roles que convierte a Claude Code en un equipo de ingeniería virtual, y su posicionamiento diferenciado en el ecosistema de herramientas de programación de IA en comparación con GSD, Superpowers, Ralph y otras soluciones.

Este artículo práctico se centra en cómo utilizar: desde la instalación y configuración hasta la ejecución del flujo de trabajo completo, ayudándole a empezar a usar gstack en 30 minutos.

Instalación y configuración

Condiciones previas

• Código Claude está instalado y disponible
• Git instalado
• Bun v1.0+ instalado (gstack está basado en Bun)
• Los usuarios de Windows también necesitan Node.js

Instalación global (recomendada, completada en 30 segundos)

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

El script de instalación hace tres cosas:

1. Agregue la información de habilidades de gstack a su archivo CLAUDE.md
2. Coloque todos los archivos de habilidades en el directorio de habilidades.
3. Instale Playwright y el navegador Chromium correspondiente (para /browse y /qa)

Instalación a nivel de proyecto (compartir en equipo)

Si desea que los miembros del equipo obtengan gstack automáticamente después de clonar el repositorio:

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

###Soporte multiagente

gstack no se limita a Claude Code y actualmente admite 10 agentes de programación de IA. ./setup detecta automáticamente los hosts instalados de forma predeterminada:

./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 会话）

La ruta de instalación de habilidades de cada host tiene la forma ~/.<agent>/skills/gstack-*/ y no interfiere entre sí.

💡 Opciones adicionales para usuarios de OpenClaw: Además de llamar a través de ACP, OpenClaw también puede instalar directamente 4 habilidades de metodología nativa (gstack-openclaw-office-hours, gstack-openclaw-ceo-review, gstack-openclaw-investigate, gstack-openclaw-retro) a través de ClawHub, que se pueden usar de manera conversacional sin una sesión de Claude Code.

Modo Equipo (Compartir equipo + Actualizaciones automáticas, recomendado)

v1.x presenta el Modo Equipo: cada desarrollador instala gstack globalmente y el almacén solo registra "usamos gstack" y las actualizaciones se realizan automáticamente:

(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"

Reemplazar required con optional es un "recordatorio amable" en lugar de obligatorio. Cada vez que inicie Claude Code, ejecutará automáticamente una verificación de actualización (aceleración una vez por hora, segura y silenciosa si falla la red). No hay archivos vendidos en el almacén y no hay cambios de versión.

Actualización

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

O use /gstack-upgrade directamente en Claude Code.

Referencia de comando completa

Proceso de sprint

Diseño

Revisión y seguridad

Pruebas y control de calidad

Lanzamiento y operación y mantenimiento.

Revisa y aprende

Protección de seguridad

Integración de herramientas

Standalone CLI（v0.19+）

Además del comando de barra diagonal, gstack también viene con un conjunto de CLI independientes (no se ejecutan dentro de la sesión de Claude Code):

Detalles de configuración

CLAUDE.md Agregar contenido

Después de la instalación, gstack agregará una lista y una breve descripción de todas las habilidades disponibles a su CLAUDE.md. Esto le permite a Claude Code saber qué comandos están disponibles.

Estructura del directorio de habilidades

La entrada principal es el ~/.claude/skills/gstack/SKILL.md de nivel superior, cada subcomando existe en forma de un directorio plano y el núcleo es el archivo 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 目录

Eres libre de modificar cualquier SKILL.md para personalizar el comportamiento; esta es la ventaja de "bifurcar y personalizar".

Browse Daemon

Browse Daemon es una instancia permanente de Chromium. Configuración clave:

• Puerto: 10000-60000 seleccionado aleatoriamente, admite más de 10 espacios de trabajo paralelos
• Seguridad: solo vincula localhost, usa autenticación de token de portador para cada sesión
• Cookie: use /setup-browser-cookies para importar desde Chrome/Arc/Brave/Edge

Demostración práctica del flujo de trabajo

A continuación se muestra un flujo de trabajo típico de gstack. Los comandos y resultados se basan en casos reales de la documentación y los vídeos.

💡 Nota: El siguiente resultado es un ejemplo general compilado en base a investigaciones. En el futuro se agregarán capturas de pantalla de proyectos específicos según la práctica real.

Paso 1: Clínica del producto

> /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

No se apresure a escribir código, primero deje que la IA atormente sus ideas desde la perspectiva del horario de oficina de YC.

Paso 2: Plan de revisión de funciones múltiples

> /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 ejecuta automáticamente tres rondas de revisiones de CEO → Diseño → Ingeniería para producir un plan completo posterior a la revisión.

Paso 3: implementación de codificación

Codifique normalmente según el plan aprobado. Puede utilizar la conversación estándar de Claude Code.

Paso 4: revisión del código por parte de múltiples expertos

> /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

Paso 5: Control de calidad del navegador

> /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

Paso 6: Publicar

> /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

Consejos prácticos y experiencia comunitaria

Sugerencia de Garry Tan

ETHOS.md de gstack, tres principios básicos:

1. Boil the Lake: la IA hace que la integridad sea casi gratuita: siempre completa las cosas y no tomes atajos
2. Buscar antes de construir: buscar primero, comprender primero y luego comenzar después de la verificación de conocimientos de tres capas.
3. Soberanía del usuario: recomendación de IA, tú decides. Incluso si ambos modelos de IA coinciden, su criterio sigue teniendo prioridad

El archivo README de gstack comienza con una cita de Karpathy; este es también el punto de partida para que el propio Garry Tan explique por qué quiere construir gstack:

Experiencias comunitarias positivas

• /office-hours para solicitudes de YC: varios solicitantes de S26 en Reddit r/ycombinator informaron que usar el horario de oficina de gstack para realizar pruebas de estrés en sus materiales de solicitud es muy efectivo.
• La auditoría de seguridad encontró vulnerabilidades reales: Hubo comentarios del CTO. /review descubrió una vulnerabilidad XSS que el equipo no conocía.
• /browse Pruebas reales de navegador: Reconocido por la comunidad (incluidos los críticos) como una "contribución verdaderamente técnica"

Errores comunes

• Solicitudes de permiso frecuentes: algunos usuarios informaron que "las solicitudes de permiso deben aprobarse cada 30 segundos, lo que hace imposible dormir". Se recomienda configurar reglas de aprobación automática apropiadas en la configuración de Claude Code
• Alto consumo de tokens: los mensajes caracterizados aumentarán el consumo de contexto. Si es sensible a los costos, puede utilizar selectivamente las habilidades que más necesita
• Agent Loop: Hay casos en HN en los que los usuarios informaron que el agente quedó atrapado en un bucle de 70 minutos. Se recomienda establecer tiempos de espera y puntos de control razonables.
• No para todos: los desarrolladores experimentados pueden sentir que la mayoría de las habilidades son envoltorios innecesarios. gstack es más adecuado para fundadores independientes y equipos pequeños que para equipos con procesos de ingeniería maduros.

Preguntas frecuentes y mejores prácticas

**P: ¿Se pueden usar gstack y Superpowers al mismo tiempo? **

Sí. Los dos se complementan entre sí: Superpowers es bueno en disciplina de procesos y garantía de TDD, y gstack es bueno en pensamiento de productos y revisiones de múltiples funciones. Muchos equipos utilizan Superpowers para la disciplina de codificación diaria y gstack para la planificación de productos y el control de calidad.

**P: ¿El token es caro? **

Superior al Código Claude nativo. El mensaje de rol de cada habilidad ocupa la ventana de contexto. Pero si su tiempo vale más que la tarifa simbólica, este suele ser un buen negocio.

**P: ¿Para qué tipo de proyectos es adecuado? **

Ideal para desarrollo de productos de proceso completo, desde la idea hasta el lanzamiento. Si simplemente corrige errores o crea pequeñas funciones, el código nativo de Claude es suficiente. El valor de gstack se maximiza en el "proceso completo".

**P: ¿Cómo personalizar la habilidad? **

Cada habilidad es un archivo SKILL.md. Simplemente edítelo directamente:

1. Busque el directorio de habilidades: ~/.claude/skills/gstack/<skill-name>/
2. Editar SKILL.md
3. Vuelva a ejecutar ./setup

La comunidad recomienda bifurcar el repositorio y personalizarlo en lugar de modificar directamente la instalación global.

Mejores prácticas

1. Primero /office-hours luego código: acostúmbrese a realizar clínicas de productos antes de escribir cualquier código.
2. Haz un buen uso de la verificación /browse: no te limites a mirar el código, deja que la IA realmente "vea" tu aplicación.
3. Periódico /retro: mantener la visibilidad de la calidad del código y el ritmo de trabajo.
4. Adopción gradual: No es necesario utilizar todas las habilidades a la vez. A partir de /office-hours + /review + /ship
5. Personalización de bifurcación: si encuentra un mensaje inapropiado, cámbielo directamente. Esta es la ventaja del código abierto.

Resumen

El valor central de gstack no radica en cuán poderosa es una habilidad específica, sino en que proporciona un modo de colaboración de IA estructurado: a través del cambio de roles, puedes obtener diferentes tipos de asistencia de IA en diferentes etapas. Primero revise la dirección del producto desde la perspectiva del CEO, luego revise la arquitectura con el rigor de un gerente de ingeniería y finalmente verifique los resultados con el navegador real de control de calidad.

A continuación, puede intentar instalarlo usted mismo y comenzar su primer proyecto de gstack desde /office-hours.

Lectura ampliada:

• gstack Concepts — Comprender los conceptos centrales y el posicionamiento ecológico de herramientas de gstack
• Capítulo práctico de GSD — Otra guía práctica para soluciones estructuradas de programación de IA
• Capítulo práctico de Habilidades de Claude — Comprender el mecanismo de creación de Habilidades