steipete/gh-cache-hygiène

Hygiène du cache et des quotas GitHub : gh, ghx, xcache, gitcrawl, miroirs, limites.

Qu'est-ce que gh-cache-hygiène ?

Cette compétence optimise l'utilisation des API GitHub en priorisant les réponses locales ou mises en cache via gitcrawl, avant de recourir aux appels live coûteux. Elle fournit les commandes `gh` adaptées à la lecture locale (recherche d'issues, de PRs, liste des runs, etc.) et indique quand rafraîchir avec un appel live (écriture, vérification finale, statut CI après un push). Elle explique comment inspecter le cache avec `gh xcache stats`, `gh xcache keys`, et `gh xcache gc`, et comment forcer le mode local avec la variable d'environnement `GITCRAWL_GH_PATH`. Enfin, elle donne des bonnes pratiques pour l'agent : regrouper les questions par dépôt, réutiliser les données affichées, éviter les boucles de polling CI serrées, et ne pas contourner le shim sauf pour diagnostiquer celui-ci.

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

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Hygiène du cache GitHub

Objectif : répondre d'abord aux questions courantes de lecture GitHub via gitcrawl et le shim gh, puis n'utiliser les appels live à l'API GitHub que lorsque la fraîcheur ou les écritures sont nécessaires.

Chemin par défaut

Utilisez gh normalement. Sur les machines de Peter, il est attendu que ce soit le shim gitcrawl, donc les lectures supportées peuvent être répondues localement ou mises en cache sans changer les commandes.

Privilégiez ces lectures locales/mises en cache :

gitcrawl sync owner/repo --numbers 123 --with pr-details
gh search issues "<termes>" -R owner/repo --state open --json number,title,state,url,updatedAt,labels,author
gh search prs "<termes>" -R owner/repo --state open --json number,title,state,url,updatedAt,isDraft,author
gh issue list -R owner/repo --state open --author user --assignee user --label bug --json number,title,url
gh pr list -R owner/repo --state open --author user --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 nom-de-branche --json databaseId,workflowName,status,conclusion,url
gh pr diff 123 -R owner/repo --patch

Utilisez des références exactes et des champs réduits. Évitez les boucles larges comme un gh issue view par résultat alors qu'un seul gh search ou gh issue list --json ... peut répondre à la première question.

Pour CI, évitez les boucles de polling serrées gh run list / gh run view. Après un push ou un déclenchement de workflow, identifiez un run exact, puis interrogez-le avec backoff. Ne récupérez les logs complets que pour les jobs en échec ou lorsque l'utilisateur demande explicitement des logs. Les endpoints de logs REST Actions de type gh run view --log, --log-failed et les endpoints courants sont mis en cache plus longtemps par gitcrawl, tandis que le statut du run reste à courte durée de vie.

Fraîcheur

Les réponses locales sont bonnes pour la découverte, la recherche de doublons, la revue de vieux fils, le tri par auteur/étiquette, et les vérifications du type « existe-t-il déjà une issue/PR ? ».

Utilisez un appel live quand :

  • écrire, commenter, fermer, fusionner, relancer ou éditer
  • vérifier l'état final actuel avant une action de mainteneur
  • vérifier le statut CI après un push
  • le résultat local est manquant ou visiblement obsolète
  • l'utilisateur demande l'état le plus récent/actuel

Pour la revue de PR, préférez hydrater les détails exacts de la PR une fois avec gitcrawl sync owner/repo --numbers <n> --with pr-details lorsque vous savez que vous inspecterez fichiers, commits, vérifications ou résumés de run plusieurs fois. Le shim gh peut auto-hydrater une PR exacte en cas d'absence, en utilisant GITHUB_TOKEN ou gh auth token ; l'hydratation explicite rend l'intention et le coût plus clairs.

Après une écriture, faites une relecture ciblée, pas une renumérisation large.

XCache

Inspectez le comportement du cache lorsque des limites de débit sont suspectées :

gh xcache stats
gh xcache keys
gh xcache gc

Lisez backend_misses_by_command et backend_misses_by_route dans gh xcache stats --json avant d'ajouter de nouvelles boucles live GitHub. Ces cartes montrent quelles formes de commandes échappent encore au cache.

Utilisez gh xcache flush uniquement lorsqu'une réponse de fallback mise en cache obsolète induit en erreur une décision.

Pour une preuve uniquement locale, rendez temporairement le backend indisponible pour une seule commande :

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

Étiquette d'agent

Regroupez les questions par dépôt et par état. Réutilisez les données déjà affichées dans la session. Limitez le polling CI ; inspectez les logs uniquement pour les runs en échec ou le run exact examiné. Ne contournez pas le shim avec /opt/homebrew/opt/gh/bin/gh sauf pour diagnostiquer le shim lui-même.

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.

Skills associés