Communitygithub.com

charlieviettq/awesome-agent-skill

Painel de fila somente leitura para ship com reconhecimento de workspace (gstack).

O que é awesome-agent-skill?

Esta skill fornece um painel de fila de versão somente leitura, orientado por workspace, que mostra quais slots de VERSION estão reservados por PRs abertos, quais workspaces do Conductor têm trabalho em andamento prestes a ser enviado e qual slot o comando /ship escolheria em seguida. Não realiza mutações — apenas um snapshot do estado atual. Ela é útil para geração de relatórios de 'aterrissagem', verificação da fila, visualização de PRs abertos e determinação da próxima versão a ser reivindicada. A skill oferece detecção de primeiro uso, prompts de configuração de telemetria e proatividade, e suporte a modo de plano, garantindo que o agente execute somente operações de leitura seguras conforme as diretrizes. Ela é projetada para ambientes Claude Code, Cursor e Codex, utilizando comandos shell e scripts auxiliares do gstack para coleta de contexto e telemetria opcional.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlieviettq/awesome-agent-skill/tree/HEAD/.claude/skills/gstack-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 VERSION estão atualmente reservados por PRs abertos, quais workspaces irmãos do Conductor têm Trabalho em Andamento (WIP) que provavelmente será enviado em breve e qual slot o comando /ship selecionaria em seguida. Nenhuma mutação — apenas um instantâneo. Use quando solicitado a "relatório de aterrissagem", "o que há na fila", "mostre-me PRs abertos" ou "qual versão devo reivindicar em seguida".

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

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 "sim" || echo "não")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "desconhecido")
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:-desconhecido}
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 do 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. Bloqueado em !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 "sim" || echo "não")
_FIRST_LOOP_SHOWN=$([ -f ~/.gstack/.first-loop-tip-shown ] && echo "sim" || echo "não")
echo "ACTIVATED: $_ACTIVATED"
echo "FIRST_LOOP_SHOWN: $_FIRST_LOOP_SHOWN"
# Detecção de primeiro projeto: execute o detector SOMENTE na primeira execução da skill
# (ACTIVATED=não, interactive) para que fique fora do caminho quente para todas as execuções seguintes.
_FIRST_TASK=""
if [ "$_ACTIVATED" = "não" ] && [ "$_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 "sim" || echo "não")
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 "sim" || echo "não")
_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:-desconhecido}")'"}'  >> ~/.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:-desconhecido}/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="não"
if [ -f CLAUDE.md ] && grep -q "## Skill routing" CLAUDE.md 2>/dev/null; then
  _HAS_ROUTING="sim"
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="não"
if [ -d ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
  if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
    _VENDORED="sim"
  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 para modo de plano para skills como /spec que alteram o comportamento com base no estado do modo de plano.
# Claude Code expõe o modo de plano por meio de lembretes de sistema; detectamos da melhor forma
# a partir de CLAUDE_PLAN_FILE (definido pelo harness quando o modo de plano está ativo) e
# e recorremos a "inactive". Hosts Codex e modo de execução Claude 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 em Modo de Plano

Em 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 da 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 da skill como instruções executáveis, não como referência. Siga-o passo a passo a partir do Passo 0; o primeiro AskUserQuestion é o fluxo de trabalho entrando no modo de plano, não uma violação dele. AskUserQuestion (qualquer variante — mcp__*__AskUserQuestion ou nativo; veja "Formato AskUserQuestion → Resolução da ferramenta") satisfaz o requisito de fim de turno do modo de 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 o fim de turno). Em um ponto de PARADA, pare imediatamente. Não continue o fluxo de trabalho nem chame ExitPlanMode ali. Comandos marcados como "EXCEÇÃO DE MODO DE PLANO — SEMPRE EXECUTAR" são executados. Chame ExitPlanMode somente após o fluxo de trabalho da skill ser concluído, ou se o usuário disser para você cancelar a skill ou sair do modo de plano.

Se PROACTIVE for "false", não invoque automaticamente nem sugira skills proativamente. Se uma skill parecer útil, pergunte: "Acho que /skillname 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 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, 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 recursos.

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

  • Ausência de ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion para auto-commits 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 sim: pergunte uma vez sobre estilo de escrita:

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

Opções:

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

Se A: deixe explain_level não definido (padrão é 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 não.

Se LAKE_INTRO for não: diga "gstack segue o princípio Ferver o Oceano — 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 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 não E LAKE_INTRO for sim: 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 caminho de arquivo. O nome do seu repositório é registrado 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, 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 sim.

Se PROACTIVE_PROMPTED for não E TEL_PROMPTED for sim: pergunte uma vez:

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

Opções:

  • A) Manter ativado (recomendado)
  • B) Desligar — vou digitar /comandos eu mesmo

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 sim.

Guia de primeira execução (uma vez)

Se ACTIVATED for não (primeira execução da skill nesta máquina) E o preâmbulo imprimiu um valor FIRST_TASK: não vazio que NÃO seja nongit: mostre UMA linha curta e específica do projeto mapeada a partir do token, como um aviso, e CONTINUE com o que o usuário realmente pediu — NÃO pare a tarefa. 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 e 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 não 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 sim E FIRST_LOOP_SHOWN for não: 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-hours ou /spec para modelar, /plan-eng-review para travar e 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 sim.

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

Use AskUserQuestion:

O 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 através da ferramenta Skill. Em caso de dúvida, invoque a skill.

Regras principais de roteamento:
- 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 completo de revisão → invocar /autoplan
- Bugs/erros → invocar /investigate
- Funcionalidade funcional? → invocar /qa
- Pronto para enviar? → invocar /ship

Se não tiver certeza, pergunte ao usuário a qual categoria sua solicitação pertence.

Sempre execute:

touch ~/.gstack/.routing-declined

Se B: execute ~/.claude/skills/gstack/bin/gstack-config set routing_declined true

Pule esta seção se HAS_ROUTING for sim ou ROUTING_DECLINED for true.

Execução da Skill

Passo 0: Executar o Preâmbulo

Execute o bloco ## Preamble (run first) acima.

Use o valor _QUESTION_TUNING para ajustar o estilo da pergunta:

  • Se true: perguntas curtas e diretas ("Qual branch?").
  • Se false (padrão): perguntas mais longas com contexto.

Passo 1: Obter Estado da Fila

~/.claude/skills/gstack/bin/gstack-landscape

Passo 2: Apresentar Painel

Mostre ao usuário uma análise dos dados retornados. Estruture-a como:

  • Slots VERSION reservados: liste PRs abertos e o slot que cada um reivindica.
  • Workspaces com WIP: liste workspaces irmãos que têm trabalho não enviado.
  • Próximo slot /ship: mostre qual slot será selecionado em seguida.
  • Snapshot somente leitura: enfatize que nenhuma mutação foi realizada.

Apresente em formato de painel legível, usando texto simples e, se aplicável, formatação para destaque.

Passo 3: Oferta de Ações

Pergunte naturalmente (em prosa) como o usuário gostaria de proceder, sem invocar nenhuma ferramenta AskUserQuestion. Use o valor _EXPLAIN_LEVEL para ajustar o estilo da resposta conforme descrito acima.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas