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:
- Leia a issue/PR, código relacionado, docs, CI e
VISION.mdse presente; use Google/docs oficiais quando os fatos podem estar desatualizados ou pouco claros. - 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.
- 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.
- 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.
- 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.
- 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çapull --ff-onlye verifique uma árvore de trabalho limpa antes de selecionar o próximo item autônomo. - 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 imagequando 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
gitcrawlse 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]