CommunityPesquisa e Análise de Dadosgithub.com

steipete/github-project-triage

Triagem de issues/PRs do GitHub: filas, CI, bloqueios, risco, prova e próximas ações.

O que é github-project-triage?

Esta skill é projetada para auxiliar mantenedores de projetos GitHub na triagem eficiente de issues e pull requests. Ela utiliza a ferramenta RepoBar para descoberta rápida de filas em repositórios e organizações relevantes, seguida por uma inspeção detalhada usando comandos `gh` (GitHub CLI). A skill foca em fornecer uma visão completa de cada item: URL, contexto, autor, confiança, adequação ao produto, risco, estado de prova/testes, bloqueadores e próxima ação. Ela suporta um modo autônomo que permite ao agente processar itens elegíveis sequencialmente, implementando correções, verificando CI e garantindo que tudo seja devidamente documentado e finalizado. A skill é construída para o ecossistema Claude Code/Codex/Cursor, usando scripts bash e ferramentas de linha de comando. Sua lógica de decisão incorpora regras de confiança baseadas no perfil do autor, análise de risco e escopo, e a presença de um arquivo `VISION.md` para alinhamento com o produto.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/github-project-triage

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

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

Documentação

GitHub Project Triage

Sempre use esta skill quando o usuário digitar triage, a menos que a solicitação tenha como alvo explícito um domínio que não seja do GitHub. De dentro de um repositório, use o projeto GitHub atual por padrão. Triagem significa cartões de itens voltados para mantenedores: URL, sobre o que é cada issue/PR, por que isso importa, confiança do autor, adequação, risco, estado de prova/teste, bloqueadores e próxima ação. Nunca retorne apenas números de fila ou referências opacas.

A saída é primeiro a URL: todo item de issue/PR/repositório exibido deve incluir sua URL do GitHub na primeira linha ou primeira frase desse item. Se fornecer uma lista resumida, imprima uma URL por item.

Use o RepoBar como primeira passagem apenas para descoberta ampla de filas em proprietários/organizações relevantes. O RepoBar é mais rápido e mais consciente de perfil do que loops manuais com gh repo list, e já entende atividade de repositório, contagens de issues, contagens de PRs, projetos locais, autenticação, cache e filtros.

Configuração

Prefira um binário repobar real quando instalado. Neste workspace, ele pode existir apenas como um produto SwiftPM em ~/Projects/RepoBar.

repobar_cmd() {
  if command -v repobar >/dev/null 2>&1; then
    repobar "$@"
  elif [ -x "$HOME/Projects/RepoBar/.build/debug/repobarcli" ]; then
    "$HOME/Projects/RepoBar/.build/debug/repobarcli" "$@"
  else
    swift run --package-path "$HOME/Projects/RepoBar" repobarcli "$@"
  fi
}

repobar_cmd status --json

Proprietários padrão para triagem ampla: steipete, openclaw. Para triagem de fila ampla/padrão, inclua uma passagem detalhada para openclaw/openclaw mesmo que não seja o primeiro repositório por contagem, porque é a fila principal do ClawdBot/OpenClaw. Não inclua amantus-ai ou outros proprietários a menos que o usuário os nomeie, o repositório atual já esteja sob esse proprietário ou a tarefa peça explicitamente por todos/tudo. Para uma tarefa específica de proprietário, não amplie além do proprietário nomeado.

Portão do Repositório Local

Antes de começar o trabalho em qualquer projeto local, verifique se o checkout está pronto:

git status --short --branch
git branch --show-current
git pull --ff-only
git status --short --branch

Proceda apenas quando o branch for main, o pull for bem-sucedido e a árvore de trabalho estiver limpa. Se o branch não for main, o pull falhar ou git status --short mostrar alterações, pare e pergunte ao Peter o que fazer. Não troque de branch, faça stash, commit, reset, restore ou limpeza sem instrução explícita.

Regra de Escopo

Se o usuário disser triage e o diretório de trabalho atual for um repositório Git com um remote do GitHub, faça a triagem apenas desse projeto. Não amplie para todas as filas de Peter/org a menos que o usuário diga broad, all, everything, nomeie vários proprietários/orgs ou peça triagem entre repositórios.

Se o repositório tiver VISION.md, leia-o antes de julgar o que pode ser tratado de forma autônoma. Use-o como a fonte da verdade de adequação ao produto, depois aplique as regras de risco/testabilidade desta skill. Se não houver VISION.md, use as regras de adequação autônoma abaixo.

Encontre o projeto atual:

repo=$(gh repo view --json nameWithOwner --jq .nameWithOwner 2>/dev/null || true)
if [ -z "$repo" ]; then
  url=$(git remote get-url origin 2>/dev/null || true)
  repo=$(printf '%s\n' "$url" |
    sed -E 's#^[email protected]:##; s#^https://github.com/##; s#\\.git$##')
fi
printf '%s\n' "$repo"

A triagem do projeto atual começa com:

gh issue list --repo "$repo" --state open --limit 50 \
  --json number,title,author,labels,createdAt,updatedAt,url
gh pr list --repo "$repo" --state open --limit 50 \
  --json number,title,author,isDraft,reviewDecision,mergeStateStatus,createdAt,updatedAt,url

Antes de agir em qualquer issue ou PR, leia todos os comentários e trate os comentários de Peter/proprietário como instruções de roteamento autoritativas. Se Peter disser que parece bom, precisa de alterações, foi substituído, está aprovado para o produto ou não é desejado, isso substitui as etiquetas do bot e o julgamento comum da triagem. Se não houver comentário de Peter/proprietário, use o julgamento de mantenedor e diga que a decisão é sua.

Em seguida, inspecione detalhes suficientes para explicar cada item exibido. Para filas pequenas (cerca de 10 itens abertos ou menos), inspecione todos os itens. Para filas maiores, inspecione a fatia de maior prioridade e diga o que não foi expandido.

gh issue view <n> --repo "$repo" \
  --json number,title,author,body,comments,labels,createdAt,updatedAt,url
gh pr view <n> --repo "$repo" \
  --json number,title,author,body,comments,files,commits,isDraft,reviewDecision,mergeStateStatus,statusCheckRollup,createdAt,updatedAt,url
gh pr diff <n> --repo "$repo" --patch

Comente, feche, mescle, reexecute ou aplique patch apenas com evidências fortes.

Saída da Triagem

Quando o usuário disser triage, sempre verifique as issues abertas e os PRs abertos do repositório atual. Retorne:

  • Candidatos autônomos: itens que parecem corrigíveis/integráveis sem mais informações do produto, com URL, por que se qualificam, verificação necessária e confiança. Esta é uma seleção para revisão, não permissão para iniciar o trabalho, a menos que o usuário também peça execução autônoma.
  • Precisa de Peter: itens bloqueados por decisão de Peter/proprietário, direção do produto, credenciais/acesso ausentes, prova ao vivo que não pode ser obtida, julgamento de segurança/privacidade ou um comentário autoritativo de Peter solicitando alterações.
  • Adiar/Fechar/Substituir: itens obsoletos, duplicados, de qualidade inferior ou sobrepostos onde a ação provável não é novo código.

Para cada candidato autônomo plausível, use subagentes de alto raciocínio disponíveis, oráculo ou revisão de agente independente para verificar a viabilidade antes de apresentá-lo quando houver suporte de ferramenta. Dê ao subagente apenas evidências locais da tarefa e pergunte se o item pode ser concluído de forma autônoma, qual verificação é necessária e o que poderia torná-lo inseguro. Se os subagentes não estiverem disponíveis, faça a mesma profundidade você mesmo e diga isso.

Modo de Trabalho Autônomo

Quando o usuário disser do work autonomously, work you can do autonomously, keep going ou similar, não pare após um resumo da fila ou um patch local. Trate isso como permissão para processar a fila de issues/PRs elegíveis sequencialmente até que nenhum item autônomo seguro permaneça, cada item seja integrado/fechado/adiado com prova, ou um bloqueador exija Peter.

Nunca trabalhe em vários tickets ao mesmo tempo. Para cada item:

  1. Leia a issue/PR, código relacionado, docs, CI e VISION.md se presente; use Google/docs oficiais quando os fatos podem estar desatualizados ou pouco claros.
  2. Decida se é autônomo:
    • Vá em frente: melhorias de desempenho a menos que a complexidade aumente demais; correções de bugs com reprodução/causa raiz e caminho de verificação; pequenos ajustes de UI/UX; correções de docs; correções de teste/interno estreitas; limpeza de dependência/CI de baixo risco com prova verde.
    • Pergunte primeiro: novos recursos, escolhas de produto/visão, mudanças amplas de comportamento, dependências arriscadas, mudanças sensíveis à segurança sem prova forte, trabalho com provedor ao vivo sem credenciais utilizáveis, qualquer coisa que não possa ser testada de ponta a ponta.
    • Preferência de refatoração: escolha uma refatoração limpa e delimitada quando for a melhor correção para um item autônomo; não use "patch pequeno" como padrão se deixar um design pior.
  3. Implemente ou corrija o PR da melhor forma sustentável. Prefira atualizar o PR do colaborador quando gravável; caso contrário, recrie localmente com crédito.
  4. Verifique localmente e ao vivo de ponta a ponta quando possível. Para comportamento de UI, use o caminho de prova de UI ao vivo esperado do repositório, como Peekaboo, browser-use, capturas de tela ou prova de VM. Para comportamento de API/provedor, use uma chave/conta real utilizável através do fluxo de segredo esperado quando disponível. Se o acesso estiver faltando, pare antes de fingir que o item está concluído e peça ajuda a Peter.
  5. Execute o Codex Auto Review antes de commit/integrar, a menos que seja trivial/somente docs ou explicitamente ignorado; resolva as descobertas aceitas/acessíveis.
  6. Garanta que o CI esteja verde, a descrição do PR/changelog esteja boa, integre/fecha/comente com evidência, então retorne ao main, faça pull --ff-only e verifique uma árvore de trabalho limpa antes de selecionar o próximo item autônomo.
  7. Após cada PR integrado, publique um comentário no PR com exatamente como foi testado: comandos locais, prova ao vivo/UI/API, execução/estado do CI, commit integrado e quaisquer ressalvas. Se imagens de verificação se aplicarem, faça upload/publique-as com gh image quando disponível; se o uploader não estiver disponível, diga isso e inclua o caminho da captura de tela ou prova de anexo alternativa do GitHub em vez de omitir imagens silenciosamente.

Não termine o modo autônomo com arquivos sujos ou uma correção local não enviada a menos que esteja bloqueado. Se bloqueado, declare o bloqueador exato, branch/status atual, prova já coletada e a próxima decisão necessária.

O trabalho autônomo ainda é limitado pelo escopo: repositório atual por padrão; filas amplas/todas apenas quando o usuário pediu amplo/tudo/todos ou nomeou proprietários/orgs.

Sinais de Confiança

Inclua confiança do autor/abridor para cada item que não seja de mantenedor que você recomendar agir. Para itens internos/de Dependabot de baixo risco, uma linha concisa de confiança bot/interno é suficiente.

Prefira o helper incluído:

skills/github-project-triage/scripts/github-activity.sh --repo <owner/repo> --global <login>

Fallback se este checkout da skill não tiver o helper:

~/Projects/clawdbot/.agents/skills/openclaw-pr-maintainer/scripts/github-activity.sh --repo <owner/repo> --global <login>

Use também github-author-context quando um PR precisar de um julgamento de confiança mais profundo, especialmente para OpenClaw, mudanças sensíveis à segurança, PRs amplos, novas contas ou comportamento incomum do autor. Prefira primeiro notas de colaboradores existentes:

~/Projects/maintainers/scripts/clawtributors find github <login>

A saída de confiança deve permanecer factual:

Trust: @login; acct 2021-04-03; repo 2 PRs/1 issue/0 commits in 12mo; GitHub 9 PRs/3 issues/12 reviews; signal: known contributor / new drive-by / bot / unknown.

Não trate confiança como prova. Ela altera a profundidade da revisão, não a correção.

Avaliação de Itens

Classifique cada item:

  • bug: exija reprodução/log/teste com falha/prova do main atual quando viável; identifique a causa raiz antes de recomendar correção/merge.
  • feature: exija um plano de teste de ponta a ponta. Se a validação ao vivo precisar de uma chave de provedor, conta, dispositivo, serviço, acesso a modelo ou API paga, diga exatamente qual credencial/acesso está faltando antes que o trabalho possa ser considerado concluído.
  • dependency: explique o grupo de pacotes, risco de versão principal/secundária, verificações com falha, alterações de runtime/engine e se deve dividir.
  • security: aumente a prioridade, exija prova cuidadosa do caminho do código, testes e confiança/contexto; não faça merge apenas com base na justificativa.
  • docs/internal: risco menor, mas ainda explique a relevância visível ao usuário e o risco de rotatividade desatualizada/gerada.

Julgue:

  • Adequação: boa / mista / ruim, com um motivo.
  • Risco: baixo / médio / alto, com raio de explosão.
  • Prova: CI atual, reprodução local, teste com falha, E2E ao vivo ou prova ausente.
  • Bloqueador: aprovação de CI de primeira contribuição, verificação com falha, chave ausente, direção de produto pouco clara, branch desatualizado, diff não confiável/amplo, sem reprodução, conflitos.
  • Próximo: aprovar CI, executar teste, solicitar reprodução, dividir PR, aplicar patch localmente, mesclar após verde, fechar com prova ou adiar.

Mapa Rápido de Fila

Use isso apenas quando o escopo for amplo. Comece com mapas de fila no nível do repositório. Isso encontra repositórios com issues abertas e/ou PRs e fornece contagens.

Fila de PRs, ordem de triagem primária:

repobar_cmd repos \
  --scope all \
  --only-with work \
  --owner steipete \
  --owner openclaw \
  --sort prs \
  --json

Pressão de issues, segunda passagem quando issues importam:

repobar_cmd repos \
  --scope all \
  --only-with work \
  --owner steipete \
  --owner openclaw \
  --sort issues \
  --json

Use --forks e --archived apenas quando o usuário disser "all", "everything" ou pedir arqueologia. A triagem padrão deve omitir forks e repositórios arquivados a menos que suas filas sejam especificamente relevantes.

Para uma visão compacta em terminal:

repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --plain

Resumo útil com jq:

repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --json |
  jq -r '.[] | [.fullName, .openIssues, .openPulls, .activityTitle, .activityActor] | @tsv'

Ao resumir uma fila ordenada por PRs, preserve a ordem da contagem de PRs do RepoBar. Não inclua um repositório com menos PRs enquanto omite um repositório com mais PRs do mesmo escopo de proprietário. Repositórios com zero issues e PRs abertos, por exemplo openclaw/crabbox, ainda são relevantes para triagem.

Passagem Detalhada

Após um mapa de fila amplo, inspecione apenas os principais repositórios, a menos que o usuário queira explicitamente detalhes exaustivos.

repobar_cmd issues <owner/name> --limit 50 --json
repobar_cmd pulls <owner/name> --limit 50 --json
repobar_cmd ci <owner/name> --limit 20 --json
repobar_cmd activity <owner/name> --limit 20 --json

Para PRs que parecem mescláveis ou suspeitos, mude para gh para estado de nível de mantenedor:

gh pr view <n> --repo <owner/name> --json number,title,state,author,isDraft,mergeStateStatus,reviewDecision,statusCheckRollup,updatedAt,url
gh pr diff <n> --repo <owner/name> --patch
gh run list --repo <owner/name> --branch <branch> --limit 10

Para issues que podem já estar corrigidas, mude para gh issue view, depois inspecione o código fonte atual antes de comentar ou fechar.

Para filas OpenClaw/ClawdBot, use a passagem de mantenedor do OpenClaw quando útil:

  • procure duplicatas/tópicos relacionados com gitcrawl se disponível;
  • use o helper de atividade para identidade do abridor/autor;
  • suprima ruído de mantenedor principal a menos que o usuário peça trabalho de propriedade do mantenedor;
  • prefira bugs relatados por usuários externos e PRs com prova clara.

Verificação Cruzada Local

Use isso quando a tarefa mencionar estado de projeto local, repositórios sujos ou "o que eu possuo aqui".

repobar_cmd local --root "$HOME/Projects" --depth 1 --limit 200 --plain
repobar_cmd local --root "$HOME/Projects" --depth 1 --sync --limit 200 --json

Não execute ações locais destrutivas (local reset, exclusões de branch, movimentos de checkout) a menos que o usuário peça explicitamente.

Heurísticas de Triagem

Priorize:

  • PRs com CI verde ou quase verde, atividade recente de mantenedor ou alterações de dependência/docs/teste de baixo risco.
  • Repositórios com altas contagens de PRs abertos, mas atividade recente, porque muitas vezes escondem limpeza óbvia.
  • Issues que são reproduzíveis, relatadas recentemente ou bloqueiam lançamentos.
  • Relatórios de segurança, lançamento, autenticação, instalação, CI e perda de dados.

...

[truncado para tradução]

Individual skills in this repo

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

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Habilidades Relacionadas