Communitygithub.com

metodologia-frames-agent-os / Francixco90

Panel de cola de solo lectura para envío consciente del espacio de trabajo (gstack).

¿Qué es Francixco90?

Esta habilidad para Claude Code (y agentes compatibles) proporciona un panel de control de versión de cola de solo lectura. Muestra qué espacios de versión están reclamados por PR abiertos, qué espacios de trabajo de Conductor hermanos tienen trabajo en progreso que probablemente se enviará pronto, y qué espacio elegiría `/ship` a continuación. No realiza mutaciones: es solo una instantánea. Es útil cuando se le pide "informe de aterrizaje", "qué hay en la cola", "muéstrame los PR abiertos" o "qué versión reclamo a continuación". La habilidad ejecuta un preámbulo para recopilar contexto del entorno (rama, modo de repositorio, tipo de sesión, configuración de telemetría) y luego proporciona instrucciones detalladas sobre el manejo de la ejecución en modo plan, la detección de habilidades proactivas, las indicaciones de configuración de primera ejecución y las reglas de enrutamiento de habilidades basadas en CLAUDE.md. Es parte del ecosistema gstack, que sigue el principio "hervir el océano" (hacer la cosa completa cuando la IA hace que el costo marginal sea casi cero).

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Francixco90/metodologia-frames-agent-os/tree/HEAD/03_artefactos/skills/vendor/gstack/landing-report

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Cuándo invocar esta habilidad

Muestra qué espacios VERSION están actualmente reclamados por PR abiertos, qué espacios de trabajo hermanos de Conductor tienen WIP que probablemente se enviará pronto, y qué espacio seleccionaría /ship a continuación. Sin mutaciones, solo una instantánea. Úsela cuando le pidan "informe de aterrizaje", "qué hay en la cola", "muéstrame los PR abiertos" 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"
# Conductor host: AskUserQuestion no es fiable aquí (nativo deshabilitado, variante MCP
# inestable), por lo que las habilidades renderizan decisiones como prosa en lugar de llamar a la
# herramienta. Bloqueado en !headless para que una ejecución de eval/CI DENTRO de Conductor (GSTACK_HEADLESS)
# aún BLOQUEE en lugar de renderizar prosa a 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 primer proyecto: ejecutar el detector SOLO en la primera ejecución de habilidad
# (ACTIVATED=no, interactivo) para que no esté en la ruta activa 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"
# Indicación de modo plan para habilidades como /spec que ramifican el comportamiento según el estado del modo plan.
# Claude Code expone el modo plan a través de recordatorios del sistema; lo detectamos en el mejor esfuerzo
# de CLAUDE_PLAN_FILE (establecido por el arnés cuando el modo plan 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 (predetermina a 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 plan

En modo plan, están permitidas porque informan el plan: $B, $D, codex exec/codex review, escrituras en ~/.gstack/, escrituras en el archivo de plan, y open para artefactos generados.

Invocación de habilidad durante el modo plan

Si el usuario invoca una habilidad en modo plan, la habilidad tiene prioridad sobre el comportamiento genérico del modo plan. Trate el archivo de habilidad como instrucciones ejecutables, no como referencia. Sígalo paso a paso desde el Paso 0; el primer AskUserQuestion es el flujo de trabajo entrando en modo plan, no una violación del mismo. AskUserQuestion (cualquier variante — mcp__*__AskUserQuestion o nativa; consulte "Formato AskUserQuestion → Resolución de herramientas") satisface el requisito de fin de turno del modo plan. Si AskUserQuestion no está disponible o una llamada falla, siga la alternativa de fallo de Formato AskUserQuestion: headless → BLOQUEADO; interactive → la alternativa de prosa (también satisface fin de turno). En un punto STOP, deténgase inmediatamente. No continúe el flujo de trabajo ni llame a ExitPlanMode allí. Los comandos marcados como "EXCEPCIÓN DE MODO PLAN — EJECUTAR SIEMPRE" se ejecutan. Llame a ExitPlanMode solo después de que el flujo de trabajo de la habilidad se complete, o si el usuario le dice que cancele la habilidad o salga del modo plan.

Si PROACTIVE es "false", no auto-invoque ni sugiera habilidades de forma proactiva. Si una habilidad parece útil, pregunte: "Creo que /skillname podría ayudar aquí — ¿quieres que lo ejecute?"

Si SKILL_PREFIX es "true", sugiera/invoque nombres /gstack-*. Las rutas de disco permanecen en ~/.claude/skills/gstack/[skill-name]/SKILL.md.

Si la salida muestra UPGRADE_AVAILABLE <old> <new>: lea ~/.claude/skills/gstack/gstack-upgrade/SKILL.md y siga el "Flujo de actualización en línea" (actualización automática si está configurado, de lo contrario AskUserQuestion con 4 opciones, escriba estado de posposición si se rechaza).

Si la salida muestra JUST_UPGRADED <from> <to>: imprima "Ejecutando gstack v{to} (¡recién actualizado!)". Si SPAWNED_SESSION es verdadero, omita 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 continuas de checkpoint. Si se acepta, ejecute ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Siempre toque el marcador.
  • Falta ~/.claude/skills/gstack/.feature-prompted-model-overlay: informe "Las superposiciones de modelo están activas. MODEL_OVERLAY muestra el parche." Siempre toque el marcador.

Después de los avisos de actualización, continúe el flujo de trabajo.

Si WRITING_STYLE_PENDING es yes: pregunte una vez sobre el estilo de escritura:

Los avisos v1 son más simples: glosarios de jerga de 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 prosa V0 — establecer explain_level: terse

Si A: deje explain_level sin establecer (predeterminado a default). Si B: ejecute ~/.claude/skills/gstack/bin/gstack-config set explain_level terse.

Ejecutar siempre (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: diga "gstack sigue el principio Hervir el océano — haga la cosa completa cuando la IA hace que el costo marginal sea casi cero. Leer más: https://garryslist.org/posts/boil-the-ocean" Ofrezca abrir:

open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen

Solo ejecute open si dice que sí. Ejecutar touch siempre.

Si TEL_PROMPTED es no Y LAKE_INTRO es yes: pregunte sobre telemetría una vez mediante AskUserQuestion:

Ayude a que gstack mejore. Comparta solo datos de uso: habilidad, duración, fallos, ID de dispositivo estable. Sin código ni rutas de archivo. El nombre de su repositorio se registra localmente solo y se elimina antes de cualquier carga.

Opciones:

  • A) ¡Ayude a que gstack mejore! (recomendado)
  • B) No, gracias

Si A: ejecute ~/.claude/skills/gstack/bin/gstack-config set telemetry community

Si B: pregunte 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: ejecute ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous Si B→B: ejecute ~/.claude/skills/gstack/bin/gstack-config set telemetry off

Ejecutar siempre:

touch ~/.gstack/.telemetry-prompted

Omitir si TEL_PROMPTED es yes.

Si PROACTIVE_PROMPTED es no Y TEL_PROMPTED es yes: pregunte una vez:

Permita que gstack sugiera habilidades de forma proactiva, como /qa para "¿esto funciona?" o /investigate para errores.

Opciones:

  • A) Mantenerlo activado (recomendado)
  • B) Desactivarlo — escribiré /comandos yo mismo

Si A: ejecute ~/.claude/skills/gstack/bin/gstack-config set proactive true Si B: ejecute ~/.claude/skills/gstack/bin/gstack-config set proactive false

Ejecutar siempre:

touch ~/.gstack/.proactive-prompted

Omitir si PROACTIVE_PROMPTED es yes.

Guía de primera ejecución (una vez)

Si ACTIVATED es no (primera ejecución de habilidad en esta máquina) Y el preámbulo imprimió un valor FIRST_TASK: no vacío que NO es nongit: muestre UNA línea corta y específica del proyecto mapeada desde el token, como aviso, luego CONTINÚE con lo que el usuario realmente pidió — NO detenga su tarea. Mapee el token: greenfield → "Repositorio fresco — moldeéelo 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 está mal." branch_ahead → "Trabajo sin enviar en esta rama — /review luego /ship." dirty_default → "Cambios sin confirmar — /review antes de confirmar." clean_default → "Elija uno: /spec, /investigate o /qa." Luego sustituya el token que vio por TASK_TOKEN y ejecute (mejor esfuerzo), y marque 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 (sin cabeza, sin git, o nada procesable): no muestre nada, solo ejecute touch ~/.gstack/.activated 2>/dev/null || true.

De lo contrario, si ACTIVATED es yes Y FIRST_LOOP_SHOWN es no: diga una vez como aviso (luego continúe):

Consejo: gstack da resultados cuando completa un bucle — planificar → revisar → enviar. Un primer bucle común: /office-hours o /spec para darle forma, /plan-eng-review para asegurarlo, luego /ship.

Luego ejecute touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true.

Omita 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: Verifique si existe un archivo CLAUDE.md en la raíz del proyecto. Si no existe, créelo.

Use AskUserQuestion:

gstack funciona mejor cuando el CLAUDE.md de su proyecto incluye reglas de enrutamiento de habilidades.

Opciones:

  • A) Agregar reglas de enrutamiento a CLAUDE.md (recomendado)
  • B) No, gracias, invocaré habilidades manualmente

Si A: Agregue esta sección al final de CLAUDE.md:


## Enrutamiento de habilidades

Cuando la solicitud del usuario coincida con una habilidad disponible, invóquela mediante la herramienta Skill. En caso de duda, invoque la habilidad.

Reglas clave de enrutamiento:
- Ideas/lluvia de ideas de producto → 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
- ¿Funciona?/probar → invocar /qa
- Vista general del plan → invocar /overview
- Envío → invocar /ship
- Desbloquearse/ayuda de diseño → invocar /office-hours

Nota: /autoplan invoca automáticamente /office-hours y /plan-eng-review en secuencia. No es necesario llamarlos por separado si usa /autoplan.

Si no está seguro, invoque /office-hours.

Luego ejecute ~/.claude/skills/gstack/bin/gstack-config set routing_declined false (no es necesario preguntar de nuevo).

Si B: ejecute ~/.claude/skills/gstack/bin/gstack-config set routing_declined true.

Flujo de trabajo principal

  1. Recolecte las variables de estado del preámbulo y continúe con el flujo de trabajo a continuación. No ejecute el preámbulo dos veces.

  2. Muestre el reporte de cola de versión. Constate qué PR están abiertos, qué ramas tienen trabajo no enviado y qué espacio versión está disponible para reclamar.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados