Cuándo invocar esta habilidad
Muestra qué espacios de VERSION están actualmente reclamados por PRs abiertas, qué espacios de trabajo de Conductor hermanos tienen trabajo WIP que probablemente se enviará pronto, y qué espacio /ship seleccionaría a continuación. Sin mutaciones — solo una instantánea. Úsalo cuando te pidan "informe de aterrizaje", "qué hay en la cola", "muéstrame las PRs abiertas" o "qué versión reclamo a continuación".
/landing-report — Panel de Cola de Versiones
Preámbulo (ejecutar primero)
_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true
mkdir -p ~/.gstack/sessions
touch ~/.gstack/sessions/"$PPID"
_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
echo "BRANCH: $_BRANCH"
_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
echo "PROACTIVE: $_PROACTIVE"
echo "PROACTIVE_PROMPTED: $_PROACTIVE_PROMPTED"
echo "SKILL_PREFIX: $_SKILL_PREFIX"
source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_SESSION_KIND=$(~/.claude/skills/gstack/bin/gstack-session-kind 2>/dev/null || echo "interactive")
case "$_SESSION_KIND" in spawned|headless|interactive) ;; *) _SESSION_KIND="interactive" ;; esac
echo "SESSION_KIND: $_SESSION_KIND"
# Host de Conductor: AskUserQuestion no es fiable aquí (nativo deshabilitado, variante
# MCP inestable), así que las habilidades convierten decisiones en prosa en lugar de llamar a la
# herramienta. Protegido por !headless para que una ejecución de evaluación/CI DENTRO de Conductor (GSTACK_HEADLESS)
# aún BLOQUEE en lugar de renderizar prosa para nadie.
if [ "$_SESSION_KIND" != "headless" ] && { [ -n "${CONDUCTOR_WORKSPACE_PATH:-}" ] || [ -n "${CONDUCTOR_PORT:-}" ]; }; then
echo "CONDUCTOR_SESSION: true"
fi
_ACTIVATED=$([ -f ~/.gstack/.activated ] && echo "yes" || echo "no")
_FIRST_LOOP_SHOWN=$([ -f ~/.gstack/.first-loop-tip-shown ] && echo "yes" || echo "no")
echo "ACTIVATED: $_ACTIVATED"
echo "FIRST_LOOP_SHOWN: $_FIRST_LOOP_SHOWN"
# Detección de proyecto en primera ejecución: ejecutar el detector SOLO en la primera ejecución de la habilidad
# (ACTIVATED=no, interactivo) para que no esté en la ruta crítica para cada ejecución posterior.
_FIRST_TASK=""
if [ "$_ACTIVATED" = "no" ] && [ "$_SESSION_KIND" != "headless" ]; then
_FIRST_TASK=$(~/.claude/skills/gstack/bin/gstack-first-task-detect 2>/dev/null || true)
fi
echo "FIRST_TASK: $_FIRST_TASK"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
echo "TELEMETRY: ${_TEL:-off}"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
_EXPLAIN_LEVEL=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "default")
if [ "$_EXPLAIN_LEVEL" != "default" ] && [ "$_EXPLAIN_LEVEL" != "terse" ]; then _EXPLAIN_LEVEL="default"; fi
echo "EXPLAIN_LEVEL: $_EXPLAIN_LEVEL"
_QUESTION_TUNING=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
echo "QUESTION_TUNING: $_QUESTION_TUNING"
mkdir -p ~/.gstack/analytics
if [ "$_TEL" != "off" ]; then
echo '{"skill":"landing-report","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(_repo=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null | tr -cd 'a-zA-Z0-9._-'); echo "${_repo:-unknown}")'"}' >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
fi
for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
if [ -f "$_PF" ]; then
if [ "$_TEL" != "off" ] && [ -x "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
fi
rm -f "$_PF" 2>/dev/null || true
fi
break
done
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
_LEARN_FILE="${GSTACK_HOME:-$HOME/.gstack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
_LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
echo "LEARNINGS: $_LEARN_COUNT entries loaded"
if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
fi
else
echo "LEARNINGS: 0"
fi
~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"landing-report","event":"started","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
_HAS_ROUTING="no"
if [ -f CLAUDE.md ] && grep -q "## Skill routing" CLAUDE.md 2>/dev/null; then
_HAS_ROUTING="yes"
fi
_ROUTING_DECLINED=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
echo "HAS_ROUTING: $_HAS_ROUTING"
echo "ROUTING_DECLINED: $_ROUTING_DECLINED"
_VENDORED="no"
if [ -d ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
_VENDORED="yes"
fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
# Indicador de modo plano para habilidades como /spec que ramifican el comportamiento según el estado del modo plano.
# Claude Code expone el modo plano a través de recordatorios del sistema; detectamos de la mejor manera posible
# a partir de CLAUDE_PLAN_FILE (establecido por el arnés cuando el modo plano está activo) y
# recurrimos a "inactive". Los hosts de Codex y el modo de ejecución de Claude terminan
# como inactivos, que es el valor predeterminado seguro (por defecto es pipeline de archivo+ejecución).
if [ -n "${CLAUDE_PLAN_FILE:-}${GSTACK_PLAN_MODE_FORCE:-}" ]; then
export GSTACK_PLAN_MODE="active"
elif [ "${GSTACK_PLAN_MODE:-}" = "active" ]; then
export GSTACK_PLAN_MODE="active"
else
export GSTACK_PLAN_MODE="inactive"
fi
echo "GSTACK_PLAN_MODE: $GSTACK_PLAN_MODE"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true
Operaciones seguras en modo plano
En modo plano, permitidas porque informan el plan: $B, $D, codex exec/codex review, escrituras en ~/.gstack/, escrituras en el archivo del plan, y open para artefactos generados.
Invocación de la habilidad durante el modo plano
Si el usuario invoca una habilidad en modo plano, la habilidad tiene prioridad sobre el comportamiento genérico del modo plano. Trata el archivo de la habilidad como instrucciones ejecutables, no como referencia. Síguelo paso a paso comenzando desde el Paso 0; la primera AskUserQuestion es el flujo de trabajo que entra en modo plano, no una violación del mismo. AskUserQuestion (cualquier variante — mcp__*__AskUserQuestion o nativa; consulta "Formato AskUserQuestion → Resolución de herramientas") satisface el requisito de fin de turno del modo plano. Si AskUserQuestion no está disponible o una llamada falla, sigue el fallo de falla del Formato AskUserQuestion: headless → BLOQUEADO; interactive → el fallback de prosa (también satisface fin de turno). En un punto STOP, detente inmediatamente. No continúes el flujo de trabajo ni llames a ExitPlanMode allí. Los comandos marcados como "EXCEPCIÓN DE MODO PLANO — EJECUTAR SIEMPRE" se ejecutan. Llama a ExitPlanMode solo después de que el flujo de trabajo de la habilidad se complete, o si el usuario te dice que canceles la habilidad o salgas del modo plano.
Si PROACTIVE es "false", no invoques ni sugieras habilidades de forma proactiva. Si una habilidad parece útil, pregunta: "Creo que /nombrehabilidad podría ayudar aquí — ¿quieres que la ejecute?"
Si SKILL_PREFIX es "true", sugiere/invoca nombres /gstack-*. Las rutas de disco permanecen en ~/.claude/skills/gstack/[skill-name]/SKILL.md.
Si la salida muestra UPGRADE_AVAILABLE <old> <new>: lee ~/.claude/skills/gstack/gstack-upgrade/SKILL.md y sigue el "Flujo de actualización en línea" (actualización automática si está configurado, de lo contrario AskUserQuestion con 4 opciones, escribe estado de posposición si se rechaza).
Si la salida muestra JUST_UPGRADED <from> <to>: imprime "Ejecutando gstack v{to} (¡recién actualizado!)". Si SPAWNED_SESSION es true, omite el descubrimiento de características.
Descubrimiento de características, máximo un aviso por sesión:
- Falta
~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion para confirmaciones automáticas de puntos de control continuos. Si se acepta, ejecuta~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Siempre toca el marcador. - Falta
~/.claude/skills/gstack/.feature-prompted-model-overlay: informa "Las superposiciones de modelo están activas. MODEL_OVERLAY muestra el parche." Siempre toca el marcador.
Después de los avisos de actualización, continúa el flujo de trabajo.
Si WRITING_STYLE_PENDING es yes: pregunta una vez sobre el estilo de escritura:
Los avisos v1 son más simples: glosarios de jerga para primer uso, preguntas enmarcadas en resultados, prosa más corta. ¿Mantener el predeterminado o restaurar el conciso?
Opciones:
- A) Mantener el nuevo predeterminado (recomendado — una buena escritura ayuda a todos)
- B) Restaurar la prosa V0 — establecer
explain_level: terse
Si A: deja explain_level sin establecer (por defecto es default).
Si B: ejecuta ~/.claude/skills/gstack/bin/gstack-config set explain_level terse.
Siempre ejecutar (independientemente de la elección):
rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted
Omitir si WRITING_STYLE_PENDING es no.
Si LAKE_INTRO es no: di "gstack sigue el principio de Hervir el Océano — haz la tarea completa cuando la IA haga que el costo marginal sea casi cero. Más información: https://garryslist.org/posts/boil-the-ocean" Ofrece abrir:
open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen
Solo ejecuta open si la respuesta es sí. Siempre ejecuta touch.
Si TEL_PROMPTED es no Y LAKE_INTRO es yes: pregunta sobre telemetría una vez mediante AskUserQuestion:
Ayuda a que gstack mejore. Comparte solo datos de uso: habilidad, duración, fallos, ID de dispositivo estable. Sin código ni rutas de archivo. El nombre de tu repositorio se registra solo localmente y se elimina antes de cualquier carga.
Opciones:
- A) ¡Ayuda a que gstack mejore! (recomendado)
- B) No, gracias
Si A: ejecuta ~/.claude/skills/gstack/bin/gstack-config set telemetry community
Si B: pregunta de seguimiento:
El modo anónimo envía solo uso agregado, sin ID único.
Opciones:
- A) Claro, el anónimo está bien
- B) No, gracias, completamente desactivado
Si B→A: ejecuta ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous
Si B→B: ejecuta ~/.claude/skills/gstack/bin/gstack-config set telemetry off
Siempre ejecutar:
touch ~/.gstack/.telemetry-prompted
Omitir si TEL_PROMPTED es yes.
Si PROACTIVE_PROMPTED es no Y TEL_PROMPTED es yes: pregunta una vez:
Permite que gstack sugiera habilidades de forma proactiva, como /qa para "¿funciona esto?" o /investigate para errores?
Opciones:
- A) Mantenerlo activado (recomendado)
- B) Desactivarlo — yo mismo escribiré los comandos /
Si A: ejecuta ~/.claude/skills/gstack/bin/gstack-config set proactive true
Si B: ejecuta ~/.claude/skills/gstack/bin/gstack-config set proactive false
Siempre ejecutar:
touch ~/.gstack/.proactive-prompted
Omitir si PROACTIVE_PROMPTED es yes.
Guía de primera ejecución (una vez)
Si ACTIVATED es no (primera habilidad ejecutada en esta máquina) Y el preámbulo imprimió un valor FIRST_TASK: no vacío que NO es nongit: muestra UNA línea corta y específica del proyecto mapeada desde el token, como aviso, luego CONTINÚA con lo que el usuario realmente pidió — no detengas su tarea. Mapa del token: greenfield → "Repositorio fresco — dale forma primero con /spec o /office-hours." code_node/code_python/code_rust/code_go/code_ruby/code_ios → "Hay código aquí — /qa para verlo funcionar, o /investigate si algo anda mal." branch_ahead → "Trabajo no enviado en esta rama — /review luego /ship." dirty_default → "Cambios sin confirmar — /review antes de confirmar." clean_default → "Elige uno: /spec, /investigate o /qa." Luego sustituye el token que viste por TASK_TOKEN y ejecuta (mejor esfuerzo), y marca como activado:
~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type first_task_scaffold_shown --skill "TASK_TOKEN" --outcome shown 2>/dev/null || true
touch ~/.gstack/.activated 2>/dev/null || true
Si ACTIVATED es no pero FIRST_TASK: está vacío o es nongit (headless, no git, o nada accionable): no muestres nada, solo ejecuta touch ~/.gstack/.activated 2>/dev/null || true.
De lo contrario, si ACTIVATED es yes Y FIRST_LOOP_SHOWN es no: di una vez como aviso (luego continúa):
Consejo: gstack da resultados cuando completas un ciclo — planificar → revisar → enviar. Un primer ciclo común:
/office-hourso/specpara darle forma,/plan-eng-reviewpara fijarlo, luego/ship.
Luego ejecuta touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true.
Omite esta sección si ACTIVATED y FIRST_LOOP_SHOWN son ambos yes.
Si HAS_ROUTING es no Y ROUTING_DECLINED es false Y PROACTIVE_PROMPTED es yes:
Verifica si existe un archivo CLAUDE.md en la raíz del proyecto. Si no existe, créalo.
Usa AskUserQuestion:
gstack funciona mejor cuando el CLAUDE.md de tu proyecto incluye reglas de enrutamiento de habilidades.
Opciones:
- A) Agregar reglas de enrutamiento a CLAUDE.md (recomendado)
- B) No, gracias, invocaré las habilidades manualmente
Si A: Agrega esta sección al final de CLAUDE.md:
## Enrutamiento de habilidades
Cuando la solicitud del usuario coincida con una habilidad disponible, invócala a través de la herramienta Skill. En caso de duda, invoca la habilidad.
Reglas clave de enrutamiento:
- Ideas de producto/lluvia de ideas → invocar /office-hours
- Estrategia/alcance → invocar /plan-ceo-review
- Arquitectura → invocar /plan-eng-review
- Sistema de diseño/revisión de plan → invocar /design-consultation o /plan-design-review
- Pipeline de revisión completo → invocar /autoplan
- Errores/fallos → invocar /investigate
Si B: ejecuta ~/.claude/skills/gstack/bin/gstack-config set routing_declined true.
Siempre ejecutar el comando de marcado.
Flujo de trabajo
- (Ya ejecutado por el preámbulo) Mostrar "🛬 Panel de cola de aterrizaje" y encabezados de versión.
- Ejecutar
~/.claude/skills/gstack/bin/gstack-queuey capturar la salida. - Mostrar la salida de la cola.
- Preguntar al usuario si desea reclamar algún espacio o continuar.
- Si el usuario elige reclamar, ejecutar
~/.claude/skills/gstack/bin/gstack-claim <version>. Mostrar confirmación. - Si el usuario elige no hacer nada, detener.
Punto de detención
Después de que se muestre la cola y se maneje la interacción, detener la ejecución.