Communitygithub.com

kelgirechandrakant-cpu/statsarthi

Panel de cola de solo lectura para ship con reconocimiento del espacio de trabajo (gstack).

¿Qué es statsarthi?

Este skill, parte del ecosistema gstack, proporciona un tablero de cola de versiones de solo lectura que permite a los desarrolladores ver qué espacios de versiones (VERSION slots) están actualmente reclamados por PRs abiertos, qué espacios de trabajo del Conductor tienen trabajo en progreso (WIP) que probablemente se enviará próximamente, y qué slot seleccionaría el comando /ship a continuación. No realiza mutaciones, solo ofrece una instantánea del estado actual de la cola. Es útil para responder a consultas como "informe de aterrizaje", "qué hay en la cola", "muéstrame los PRs abiertos" o "qué versión reclamo a continuación". El skill está diseñado para plataformas como Claude Code, Cursor y Codex, e incluye lógica de detección de modo de plan, manejo de actualizaciones, telemetría opcional y configuración de preferencias de usuario. Su ejecución comienza con un preámbulo que recopila información del entorno y del repositorio, seguido de la lógica principal que determina el estado de la cola. El flujo de trabajo incluye pasos para manejar actualizaciones automáticas, encuestas de características y guías para nuevos usuarios, todo ello respetando la configuración de proactividad del skill (PROACTIVE) y el prefijo de commandos (SKILL_PREFIX).

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/skills/landing-report

Preguntar en tu IA favorita

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

Documentación

Cuándo invocar este skill

Muestra qué espacios de VERSION están actualmente reclamados por PRs abiertos, qué espacios de trabajo del Conductor hermano tienen trabajo en progreso (WIP) que probablemente se enviará pronto, y qué slot seleccionaría /ship a continuación. Sin mutaciones — solo una instantánea. Usar cuando se pida "informe de aterrizaje", "qué hay en la cola", "muéstrame los PRs 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"
# Host del Conductor: AskUserQuestion no es confiable aquí (nativo deshabilitado, variante MCP
# inestable), por lo que los skills renderizan decisiones como prosa en lugar de llamar a la
# herramienta. Bloqueado en !headless para que una ejecución de evaluación/CI DENTRO del 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 proyecto en primera ejecución: ejecutar el detector SOLO en la primera ejecución del skill
# (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"
_UPDATE_CHECK=$(~/.claude/skills/gstack/bin/gstack-config get update_check 2>/dev/null || echo "true")
echo "UPDATE_CHECK: $_UPDATE_CHECK"
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 "$HOME/.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 entradas cargadas"
  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"
for _RF in CLAUDE.md AGENTS.md; do
  if [ -f "$_RF" ] && grep -q "## Skill routing" "$_RF" 2>/dev/null; then
    _HAS_ROUTING="yes"
  fi
done
_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 de plan para skills como /spec que ramifican su comportamiento según el estado del modo de plan.
# Claude Code expone el modo de plan a través de recordatorios del sistema; lo detectamos con el mejor esfuerzo
# a partir de CLAUDE_PLAN_FILE (establecido por el harness cuando el modo de plan está activo) y
# recurrimos a "inactivo". Los hosts de Codex y el modo de ejecución de Claude terminan en inactivo,
# que es el valor predeterminado seguro (por defecto es la canalización 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 de Plan

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

Invocación del Skill Durante el Modo de Plan

Si el usuario invoca un skill en modo de plan, el skill tiene prioridad sobre el comportamiento genérico del modo de plan. Trata el archivo del skill como instrucciones ejecutables, no como referencia. Síguelo paso a paso comenzando desde el Paso 0; cualquier AskUserQuestion que el skill dispare es el flujo de trabajo operando dentro del modo de plan, no una violación del mismo — y un skill cuyas instrucciones resuelven una pregunta por sí mismas (por ejemplo, una auto-selección en modo de plan) puede legítimamente no hacerla. AskUserQuestion (cualquier variante — mcp__*__AskUserQuestion o nativa; ver "Formato AskUserQuestion → Resolución de herramienta") satisface el requisito de fin de turno del modo de plan. Si AskUserQuestion no está disponible o una llamada falla, sigue el respaldo de fallo del Formato AskUserQuestion: headless → BLOQUEADO; interactive → el respaldo de prosa (también satisface el 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 DEL MODO DE PLAN — EJECUTAR SIEMPRE" se ejecutan. Llama a ExitPlanMode solo después de que el flujo de trabajo del skill se complete, o si el usuario te dice que canceles el skill o salgas del modo de plan.

Si PROACTIVE es "false", no invoques automáticamente ni sugieras skills de forma proactiva. Si un skill parece útil, pregunta: "Creo que /skillname podría ayudar aquí — ¿quieres que lo ejecute?"

Si SKILL_PREFIX es "true", sugiere/invoca nombres /gstack-*. Las rutas de disco permanecen ~/.claude/skills/gstack/[nombre-del-skill]/SKILL.md.

Si UPDATE_CHECK es "false", salta las siguientes dos líneas — el binario de verificación de actualizaciones no emite nada en ese modo, por lo que no hay salida UPGRADE_AVAILABLE / JUST_UPGRADED en la que actuar.

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á configurada, 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, salta 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 auto-commits de checkpoint continuo. 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 con 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 escueto?

Opciones:

  • A) Mantener el nuevo predeterminado (recomendado — una buena escritura ayuda a todos)
  • B) Restaurar 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

Saltar si WRITING_STYLE_PENDING es no.

Si LAKE_INTRO es no: di "gstack sigue el principio Hervir el Océano — haz la cosa completa cuando la IA hace que el costo marginal sea casi cero. Leer más: 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 es sí. Siempre ejecuta touch.

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

Ayuda a que gstack mejore. Comparte solo datos de uso: skill, duración, fallos, ID de dispositivo estable. Sin código ni rutas de archivos. El nombre de tu repositorio se registra 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 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

Saltar si TEL_PROMPTED es yes.

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

¿Dejar que gstack sugiera skills 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: 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

Saltar si PROACTIVE_PROMPTED es yes.

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

Si ACTIVATED es no (primera ejecución del skill 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. Mapea el token: greenfield → "Repositorio nuevo — 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 está mal." branch_ahead → "Trabajo no enviado en esta rama — /review luego /ship." dirty_default → "Cambios sin commit — /review antes de commitear." clean_default → "Elige uno: /spec, /investigate o /qa." Luego sustituye el token que viste por TASK_TOKEN y ejecuta (con el 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 procesable): 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 sus frutos cuando completas un bucle — planificar → revisar → enviar. Un primer bucle común: /office-hours o /spec para darle forma, /plan-eng-review para fijarlo, luego /ship.

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

Saltar 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 skills.

Opciones:

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

... [truncado para traducción]

Individual skills in this repo

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

Skills relacionados