Communitygithub.com

statsarthi — Painel de Filas para Ship (somente leitura)

Painel somente leitura para filas de versão compatível com workspaces Conductor (gstack).

O que é statsarthi — Painel de Filas para Ship (somente leitura)?

statsarthi é uma skill de IA projetada para desenvolvedores que usam gstack e Conductor. Ela fornece um painel de filas somente leitura que mostra quais slots de versão estão atualmente reivindicados por PRs abertos, quais workspaces irmãos do Conductor têm trabalho em andamento prestes a serem enviados (ship), e qual slot a ferramenta /ship selecionaria em seguida. Nenhuma mutação — apenas um snapshot do estado atual. A skill é útil quando perguntas como 'relatório de landing', 'o que está na fila', 'mostre-me os PRs abertos' ou 'qual versão devo reivindicar' são feitas. Ela suporta Claude Code e Conductor, e funciona executando uma série de comandos para coletar informações de ambiente e de configuração, verificar atualizações, gerenciar sessões e aprendizado do projeto, e fornecer orientações de primeiro uso. Inclui verificações de modo de plano, descoberta de funcionalidades e prompts de telemetria/estilo de escrita.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Quando invocar esta skill

Mostra quais slots de VERSÃO estão atualmente reivindicados por PRs abertos, quais workspaces irmãos do Conductor têm WIP que provavelmente será enviado em breve, e qual slot o /ship selecionaria em seguida. Sem mutações — apenas um snapshot. Use quando for solicitado algo como "relatório de landing", "o que está na fila", "mostre-me os PRs abertos" ou "qual versão devo reivindicar em seguida".

/landing-report — Painel de Filas de Versão

Preâmbulo (execute primeiro)

_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 não é confiável aqui (nativo desabilitado, variante MCP
# instável), então as skills renderizam decisões como prosa em vez de chamar a
# ferramenta. Condicionado a !headless para que uma execução de avaliação/CI DENTRO do Conductor (GSTACK_HEADLESS)
# ainda BLOQUEIE em vez de renderizar prosa para ninguém.
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"
# Detecção de projeto na primeira execução: execute o detector APENAS na primeira execução da skill
# (ACTIVATED=no, interativo) para que fique fora do caminho crítico nas execuções seguintes.
_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 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"
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"
# Dica de modo de plano para skills como /spec que ramificam o comportamento com base no estado do modo de plano.
# Claude Code expõe o modo de plano via lembretes do sistema; detectamos da melhor forma
# possível a partir de CLAUDE_PLAN_FILE (definido pelo harness quando o modo de plano está ativo) e
# fazemos fallback para "inactive". Hosts Codex e modo de execução Claude ambos terminam
# como inactive, que é o padrão seguro (padrão para pipeline de arquivo+execução).
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

Operações Seguras no Modo de Plano

No modo de plano, permitidas porque informam o plano: $B, $D, codex exec/codex review, gravações em ~/.gstack/, gravações no arquivo de plano, e open para artefatos gerados.

Invocação de Skill Durante o Modo de Plano

Se o usuário invocar uma skill no modo de plano, a skill tem precedência sobre o comportamento genérico do modo de plano. Trate o arquivo de skill como instruções executáveis, não como referência. Siga-o passo a passo começando do Passo 0; qualquer AskUserQuestion que a skill disparar é o fluxo de trabalho operando dentro do modo de plano, não uma violação dele — e uma skill cujas instruções resolvem uma pergunta por si mesmas (por exemplo, uma seleção automática no modo de plano) pode legitimamente não fazê-la. AskUserQuestion (qualquer variante — mcp__*__AskUserQuestion ou nativa; veja "Formato AskUserQuestion → Resolução de ferramentas") satisfaz o requisito de fim de turno do modo de plano. Se AskUserQuestion estiver indisponível ou uma chamada falhar, siga o fallback de falha do Formato AskUserQuestion: headless → BLOQUEADO; interactive → o fallback de prosa (também satisfaz o fim de turno). Em um ponto de PARADA, pare imediatamente. Não continue o fluxo de trabalho nem chame ExitPlanMode lá. Comandos marcados como "EXCEÇÃO DO MODO DE PLANO — SEMPRE EXECUTAR" executam. Chame ExitPlanMode apenas após o fluxo de trabalho da skill ser concluído, ou se o usuário disser para cancelar a skill ou sair do modo de plano.

Se PROACTIVE for "false", não invoque automaticamente nem sugira proativamente skills. Se uma skill parecer útil, pergunte: "Acho que /nomedaskill pode ajudar aqui — quer que eu execute?"

Se SKILL_PREFIX for "true", sugira/invoque nomes /gstack-*. Os caminhos de disco permanecem ~/.claude/skills/gstack/[skill-name]/SKILL.md.

Se UPDATE_CHECK for "false", pule as próximas duas linhas — o binário de verificação de atualização não emite nada nesse modo, portanto não há saída UPGRADE_AVAILABLE / JUST_UPGRADED para agir.

Se a saída mostrar UPGRADE_AVAILABLE <old> <new>: leia ~/.claude/skills/gstack/gstack-upgrade/SKILL.md e siga o "fluxo de upgrade inline" (atualização automática se configurada, caso contrário AskUserQuestion com 4 opções, grave estado de adiamento se recusado).

Se a saída mostrar JUST_UPGRADED <from> <to>: imprima "Executando gstack v{to} (acabou de atualizar!)". Se SPAWNED_SESSION for true, pule a descoberta de funcionalidades.

Descoberta de funcionalidades, no máximo um prompt por sessão:

  • Ausência de ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion para commits automáticos de checkpoint contínuo. Se aceito, execute ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Sempre marque o marcador.
  • Ausência de ~/.claude/skills/gstack/.feature-prompted-model-overlay: informe "Sobreposições de modelo estão ativas. MODEL_OVERLAY mostra o patch." Sempre marque o marcador.

Após prompts de upgrade, continue o fluxo de trabalho.

Se WRITING_STYLE_PENDING for yes: pergunte uma vez sobre o estilo de escrita:

Os prompts v1 são mais simples: glossários de jargão no primeiro uso, perguntas com resultado enquadrado, prosa mais curta. Manter padrão ou restaurar conciso?

Opções:

  • A) Manter o novo padrão (recomendado — uma boa escrita ajuda a todos)
  • B) Restaurar prosa V0 — definir explain_level: terse

Se A: deixe explain_level não definido (padrão para default). Se B: execute ~/.claude/skills/gstack/bin/gstack-config set explain_level terse.

Sempre execute (independentemente da escolha):

rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted

Pule se WRITING_STYLE_PENDING for no.

Se LAKE_INTRO for no: diga "gstack segue o princípio Boil the Ocean — faça a coisa completa quando a IA torna o custo marginal quase zero. Leia mais: https://garryslist.org/posts/boil-the-ocean" Ofereça-se para abrir:

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

Execute open apenas se sim. Sempre execute touch.

Se TEL_PROMPTED for no E LAKE_INTRO for yes: pergunte sobre telemetria uma vez via AskUserQuestion:

Ajude o gstack a melhorar. Compartilhe apenas dados de uso: skill, duração, travamentos, ID de dispositivo estável. Nenhum código ou caminhos de arquivo. O nome do seu repositório é gravado localmente e removido antes de qualquer upload.

Opções:

  • A) Ajude o gstack a melhorar! (recomendado)
  • B) Não, obrigado

Se A: execute ~/.claude/skills/gstack/bin/gstack-config set telemetry community

Se B: pergunte acompanhamento:

Modo anônimo envia apenas uso agregado, sem ID único.

Opções:

  • A) Claro, anônimo está bem
  • B) Não, obrigado, completamente desligado

Se B→A: execute ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous Se B→B: execute ~/.claude/skills/gstack/bin/gstack-config set telemetry off

Sempre execute:

touch ~/.gstack/.telemetry-prompted

Pule se TEL_PROMPTED for yes.

Se PROACTIVE_PROMPTED for no E TEL_PROMPTED for yes: pergunte uma vez:

Deixe o gstack sugerir proativamente skills, como /qa para "isso funciona?" ou /investigate para bugs?

Opções:

  • A) Mantenha ativado (recomendado)
  • B) Desative — eu mesmo digitarei /comandos

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

Sempre execute:

touch ~/.gstack/.proactive-prompted

Pule se PROACTIVE_PROMPTED for yes.

Orientação de primeiro uso (única)

Se ACTIVATED for no (primeira execução da skill nesta máquina) E o preâmbulo imprimiu um valor FIRST_TASK: não vazio que NÃO é nongit: mostre UMA linha curta e específica do projeto mapeada a partir do token, como um aviso, depois CONTINUE com o que o usuário realmente pediu — NÃO interrompa a tarefa deles. Mapeie o token: greenfield → "Repositório novo — modele-o primeiro com /spec ou /office-hours." code_node/code_python/code_rust/code_go/code_ruby/code_ios → "Há código aqui — /qa para vê-lo funcionar, ou /investigate se algo estiver estranho." branch_ahead → "Trabalho não enviado neste branch — /review depois /ship." dirty_default → "Alterações não confirmadas — /review antes de confirmar." clean_default → "Escolha um: /spec, /investigate ou /qa." Em seguida, substitua o token que você viu por TASK_TOKEN e execute (melhor esforço), e marque como ativado:

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

Se ACTIVATED for no mas FIRST_TASK: estiver vazio ou for nongit (headless, não-git ou nada acionável): não mostre nada, apenas execute touch ~/.gstack/.activated 2>/dev/null || true.

Senão, se ACTIVATED for yes E FIRST_LOOP_SHOWN for no: diga uma vez como um aviso (depois continue):

Dica: gstack compensa quando você completa um loop — planejar → revisar → enviar. Um primeiro loop comum: /office-hours ou /spec para modelar, /plan-eng-review para travar, depois /ship.

Em seguida, execute touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true.

Pule esta seção se ACTIVATED e FIRST_LOOP_SHOWN forem ambos yes.

Se HAS_ROUTING for no E ROUTING_DECLINED for false E PROACTIVE_PROMPTED for yes: Verifique se um arquivo CLAUDE.md existe na raiz do projeto. Se não existir, crie-o.

Use AskUserQuestion:

gstack funciona melhor quando o CLAUDE.md do seu projeto inclui regras de roteamento de skill.

Opções:

  • A) Adicionar regras de roteamento ao CLAUDE.md (recomendado)
  • B) Não, obrigado, invocarei skills manualmente

Individual skills in this repo

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

Habilidades Relacionadas