Quando invocar esta skill
Mostra quais slots de VERSÃO estão atualmente reivindicados por PRs abertos, quais espaços de trabalho do Conductor irmão têm trabalho em andamento (WIP) com probabilidade de ser enviado em breve e qual slot /ship selecionaria em seguida. Nenhuma mutação — apenas um instantâneo. Use quando solicitado "relatório de pouso", "o que está na fila", "mostre-me PRs abertos" ou "qual versão eu reivindico a seguir".
/landing-report — Painel da Fila de Versões
Preâmbulo (executar 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"
# Host Conductor: 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. Fechado em !headless para que uma execução eval/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: executa o detector APENAS na primeira execução da skill
# (ACTIVATED=no, interactive) para que permaneça fora do caminho crítico para todas as execuções posteriores.
_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 entradas carregadas"
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"
# Dica de modo Plano para skills como /spec que ramificam o comportamento com base no estado do modo plano.
# Claude Code expõe o modo plano por meio de lembretes do sistema; detectamos da melhor forma
# possível a partir de CLAUDE_PLAN_FILE (definido pelo harness quando o modo plano está ativo) e
# recorremos a "inactive". Os hosts Codex e o modo de execução Claude ambos terminam
# inativos, que é o padrão seguro (padrão para pipeline 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 do Modo Plano
No modo 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 Plano
Se o usuário invocar uma skill no modo plano, a skill tem precedência sobre o comportamento genérico do modo plano. Trate o arquivo de skill como instruções executáveis, não como referência. Siga-o passo a passo começando da Etapa 0; o primeiro AskUserQuestion é o fluxo de trabalho entrando no modo plano, não uma violação dele. AskUserQuestion (qualquer variante — mcp__*__AskUserQuestion ou nativa; consulte "Formato AskUserQuestion → Resolução de Ferramenta") satisfaz o requisito de fim de turno do modo plano. Se AskUserQuestion não estiver disponível ou uma chamada falhar, siga a alternativa de falha do Formato AskUserQuestion: headless → BLOQUEADO; interactive → a alternativa em prosa (também satisfaz fim de turno). Em um ponto STOP, pare imediatamente. Não continue o fluxo de trabalho ou chame ExitPlanMode lá. Comandos marcados como "EXCEÇÃO DO MODO PLANO — EXECUTAR SEMPRE" executam. Chame ExitPlanMode somente 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 plano.
Se PROACTIVE for "false", não invoque automaticamente ou sugira proativamente skills. Se uma skill parecer útil, pergunte: "Acho que /skillname pode ajudar aqui — quer executá-la?"
Se SKILL_PREFIX for "true", sugira/invoque nomes /gstack-*. Os caminhos do disco permanecem ~/.claude/skills/gstack/[skill-name]/SKILL.md.
Se a saída mostrar UPGRADE_AVAILABLE <old> <new>: leia ~/.claude/skills/gstack/gstack-upgrade/SKILL.md e siga o "fluxo de atualização inline" (atualização automática se configurada, caso contrário AskUserQuestion com 4 opções, escreva estado de adiamento se recusado).
Se a saída mostrar JUST_UPGRADED <from> <to>: imprima "Executando gstack v{to} (recém-atualizado!)". Se SPAWNED_SESSION for true, pule a descoberta de recursos.
Descoberta de recursos, 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 toque no 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 toque no marcador.
Após prompts de atualização, continue o fluxo de trabalho.
Se WRITING_STYLE_PENDING for yes: pergunte uma vez sobre estilo de escrita:
Os prompts v1 são mais simples: glossários de jargão para primeiro uso, perguntas com foco em resultados, prosa mais curta. Manter o padrão ou restaurar o conciso?
Opções:
- A) Manter o novo padrão (recomendado — 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 Ferver o Oceano — faça a coisa completa quando a IA torna o custo marginal próximo de 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, falhas, ID de dispositivo estável. Sem código ou caminhos de arquivo. O nome do seu repositório é registrado apenas 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:
O modo anônimo envia apenas uso agregado, sem ID único.
Opções:
- A) Claro, anônimo está bem
- B) Não, obrigado, totalmente 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:
Deixar o gstack sugerir proativamente skills, como /qa para "isso funciona?" ou /investigate para bugs?
Opções:
- A) Manter ligado (recomendado)
- B) Desligar — eu mesmo digitarei os /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 primeira execução (única)
Se ACTIVATED for no (primeira execução de 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, então CONTINUE com o que o usuário realmente pediu — NÃO pare a tarefa dele. 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 errado." 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 aviso (então continue):
Dica: o gstack compensa quando você completa um loop — planejar → revisar → enviar. Um primeiro loop comum:
/office-hoursou/specpara modelar,/plan-eng-reviewpara travar e depois/ship.
Então 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
Se A: Anexe esta seção ao final do CLAUDE.md:
## Skill routing
Quando a solicitação do usuário corresponder a uma skill disponível, invoque-a por meio da ferramenta Skill. Em caso de dúvida, invoque a skill.
Regras de roteamento principais:
- Ideias de produto/brainstorming → invocar /office-hours
- Estratégia/escopo → invocar /plan-ceo-review
- Arquitetura → invocar /plan-eng-review
- Sistema de design/revisão de plano → invocar /design-consultation ou /plan-design-review
- Pipeline de revisão completo → invocar /autoplan
- Bugs/erros → invocar
...[truncado para tradução]