Communitygithub.com

charlieviettq/awesome-agent-skill

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

O que é awesome-agent-skill?

Este skill fornece um painel de fila de versões em formato de snapshot, mostrando quais slots de VERSION estão atualmente reivindicados por PRs abertos, quais workspaces Conductor irmãos têm trabalho WIP que provavelmente será enviado em breve e qual slot o comando /ship selecionaria em seguida. É um comando somente leitura, sem mutações. O skill é mais útil quando um desenvolvedor pede um "relatório de pouso", "o que está na fila", "mostre PRs abertos" ou "qual versão devo reivindicar em seguida". Ele suporta plataformas como Claude Code, Cursor e Codex, e funciona através de um preâmbulo de shell que coleta informações de sessão, telemetria e configuração antes de renderizar o relatório. O markdown completo do SKILL.md inclui instruções detalhadas sobre quando invocar, operações seguras em modo de plano, tratamento de prompts únicos (telemetria, sugestão proativa, estilo de escrita) e orientação para primeira execução.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlieviettq/awesome-agent-skill/tree/HEAD/.cursor/skills/gstack/deploy-ship/landing-report

Perguntar na sua IA favorita

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

Documentação

Quando invocar este skill

Mostra quais slots VERSION estão atualmente reivindicados por PRs abertos, quais workspaces Conductor irmãos têm trabalho WIP com probabilidade de enviar em breve e qual slot o /ship selecionaria em seguida. Sem mutações — apenas um instantâneo. Use quando for solicitado "relatório de pouso", "o que está na fila", "me mostre PRs abertos" ou "qual versão devo reivindicar em seguida".

/landing-report — Painel da Fila de Versões

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, MCP
# variante instável), então 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 "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 do skill
# (ACTIVATED=no, interativo) para que fique fora do caminho crítico para todas as 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"
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 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 através de lembretes do sistema; detectamos melhor esforço
# de CLAUDE_PLAN_FILE (definido pelo harness quando o modo de plano está ativo) e
# recuamos para "inactive". Hosts Codex e modo de execução Claude ambos terminam
# inativos, 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, permitido 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 um skill no modo de plano, o 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; a primeira AskUserQuestion é o fluxo de trabalho entrando no modo de plano, não uma violação dele. AskUserQuestion (qualquer variante — mcp__*__AskUserQuestion ou nativa; consulte "Formato AskUserQuestion → Resolução da ferramenta") 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 em prosa (também satisfaz fim de turno). Em um ponto STOP, pare imediatamente. Não continue o fluxo de trabalho nem chame ExitPlanMode lá. Comandos marcados como "EXCEÇÃO DE MODO DE PLANO — SEMPRE EXECUTAR" executam. Chame ExitPlanMode somente após o fluxo de trabalho do skill ser concluído, ou se o usuário disser para cancelar o skill ou sair do modo de plano.

Se PROACTIVE for "false", não auto-invoque ou sugira skills proativamente. Se um skill parecer útil, pergunte: "Acho que /skillname pode ajudar aqui — quer executar?"

Se SKILL_PREFIX for "true", sugira/invoque nomes /gstack-*. 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 upgrade inline" (auto-upgrade se configurado, 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} (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 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 upgrade, continue o fluxo de trabalho.

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

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

Opções:

  • A) Manter o novo padrão (recomendado — boa escrita ajuda 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 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 telemetria uma vez via AskUserQuestion:

Ajude o gstack a melhorar. Compartilhe apenas dados de uso: habilidade, duração, travamentos, ID de dispositivo estável. Nenhum código ou caminhos de arquivo. O nome do seu repositório é gravado localmente apenas 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:

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

Opções:

  • A) Manter ligado (recomendado)
  • B) Desligar — 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 primeira execução (única)

Se ACTIVATED for no (primeira execução de skill nesta máquina) E o preâmbulo imprimiu um valor não vazio FIRST_TASK: que NÃO é nongit: mostre UMA linha curta e específica do projeto mapeada do token, como um aviso, então CONTINUE com o que o usuário realmente pediu — NÃO pare a tarefa. Mapeie o token: greenfield → "Repositório novo — modele 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 um 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, 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

Se A: Anexe esta seção ao final de CLAUDE.md:


## Skill routing

Quando a solicitação do usuário corresponder a um skill disponível, invoque-o via a ferramenta Skill. Em caso de dúvida, invoque o 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 /investigate
- "Isso funciona?" / testes → invocar /qa
- Solicitar revisão de código → invocar /review
- Enviar trabalho → invocar /ship
- Relatório de pouso / status da fila → invocar /landing-report
- Rascunho de especificação → invocar /spec
- Melhoria de repositório / CI → invocar /office-hours
- Chamada de arquitetura / decisão técnica → invocar /office-hours
- Qualquer outra ambiguidade → invocar /office-hours

Para habilidades /gstack-*, sempre invoque o nome completo (por exemplo, /gstack-checkpoint, /gstack-reset).

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

Sempre execute touch ~/.gstack/.routing-prompted 2>/dev/null || true.

Individual skills in this repo

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

Habilidades Relacionadas