CommunityPesquisa e Análise de Dadosgithub.com

steipete/github-cache-hygiene

Higiene de cache/quota do GitHub: gh, ghx, xcache, gitcrawl, mirrors, limites.

O que é github-cache-hygiene?

Esta skill otimiza o uso dos comandos `gh` e `gitcrawl` para reduzir chamadas diretas à API do GitHub, priorizando respostas locais ou em cache sempre que possível. Ela é útil para desenvolvedores que trabalham com repositórios grandes ou muitos repositórios e enfrentam limites de taxa da API. A skill suporta as ferramentas `gh`, `gitcrawl` e `xcache` do GitHub CLI, e funciona através de um shim que intercepta comandos `gh` para responder leituras comuns (como listar issues/PRs, visualizar detalhes, buscar logs de CI) a partir do cache local, sem gastar chamadas de API. Ela define diretrizes claras sobre quando usar cache versus chamadas ao vivo, como hidratar PRs conforme necessário e como inspecionar o comportamento do cache com `gh xcache stats`. Também orienta sobre etiqueta do agente para evitar loops desnecessários de polling e reutilizar dados já obtidos na sessão.

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

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

Higiene de Cache do GitHub

Objetivo: responder perguntas comuns de leitura do GitHub primeiro a partir do gitcrawl e do shim gh, gastando chamadas ao vivo da API do GitHub apenas quando a atualização ou escritas importam.

Caminho Padrão

Use gh normalmente. Nas máquinas do Peter, espera-se que seja o shim baseado em gitcrawl, então leituras suportadas podem ser respondidas localmente ou em cache sem alterar comandos.

Prefira estas leituras locais/em cache:

gitcrawl sync owner/repo --numbers 123 --with pr-details
gh search issues "<termos>" -R owner/repo --state open --json number,title,state,url,updatedAt,labels,author
gh search prs "<termos>" -R owner/repo --state open --json number,title,state,url,updatedAt,isDraft,author
gh issue list -R owner/repo --state open --author usuario --assignee usuario --label bug --json number,title,url
gh pr list -R owner/repo --state open --author usuario --label dependencies --json number,title,url
gh issue view 123 -R owner/repo --json number,title,state,body,comments,labels,url
gh pr view 123 -R owner/repo --json number,title,state,body,comments,labels,files,commits,statusCheckRollup,url
gh pr checks 123 -R owner/repo --json name,state,detailsUrl,workflow
gh run list -R owner/repo --branch nome-da-branch --json databaseId,workflowName,status,conclusion,url
gh pr diff 123 -R owner/repo --patch

Use referências exatas e campos específicos. Evite loops amplos como um gh issue view por resultado quando um único gh search ou gh issue list --json ... pode responder a pergunta inicial.

Para CI, evite loops de polling apertados de gh run list / gh run view. Após um push ou workflow dispatch, identifique uma execução exata e então faça polling com backoff. Busque logs completos apenas para jobs com falha ou quando o usuário solicitar explicitamente logs. gh run view --log, --log-failed e endpoints comuns de log do Actions REST são cacheados por mais tempo pelo gitcrawl, enquanto o status da execução fica com cache curto.

Frescor

Respostas locais são boas para descoberta, busca de duplicatas, revisão de threads antigas, triagem por autor/rótulo e verificações do tipo "já existe um issue/PR sobre isso?" .

Use uma chamada ao vivo quando:

  • escrevendo, comentando, fechando, mesclando, reexecutando ou editando
  • verificando o estado final antes de uma ação de mantenedor
  • confirmando status de CI após um push
  • o resultado local está faltando ou obviamente desatualizado
  • o usuário solicita o estado mais recente/atual

Para revisão de PR, prefira hidratar os detalhes exatos do PR uma vez com gitcrawl sync owner/repo --numbers <n> --with pr-details quando você sabe que irá inspecionar arquivos, commits, verificações ou resumos de execuções repetidamente. O shim gh pode hidratar automaticamente um PR exato em caso de falta, usando GITHUB_TOKEN ou gh auth token; hidratação explícita deixa intenção e custo mais claros.

Após uma escrita, faça uma leitura de volta direcionada, não uma varredura ampla.

XCache

Inspecione o comportamento do cache quando os limites de taxa forem suspeitos:

gh xcache stats
gh xcache keys
gh xcache gc

Leia backend_misses_by_command e backend_misses_by_route em gh xcache stats --json antes de adicionar novos loops ao vivo do GitHub. Esses mapas mostram quais formatos de comando ainda estão escapando do cache.

Use gh xcache flush apenas quando um fallback de cache desatualizado estiver enganando uma decisão.

Para prova apenas local, torne temporariamente o backend indisponível para um único comando:

GITCRAWL_GH_PATH=/tmp/no-real-gh gh search issues "<termos>" -R owner/repo --json number,title,url

Etiqueta do Agente

Agrupe perguntas por repositório e estado. Reutilize dados já exibidos na sessão. Faça backoff de polling de CI; inspecione logs apenas para execuções com falha ou a execução exata sob revisão. Não contorne o shim com /opt/homebrew/opt/gh/bin/gh a menos que esteja diagnosticando o próprio shim.

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-deep-review

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

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

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