CommunityRecherche & Datenanalysegithub.com

steipete/github-cache-hygiene

GitHub-Quoten/Cache-Hygiene: gh, ghx, xcache, gitcrawl, Spiegel, Limits.

Was ist github-cache-hygiene?

Dieses Skill optimiert die Nutzung von GitHub-APIs, indem es lokale und zwischengespeicherte Lesevorgänge priorisiert, bevor Live-Aufrufe getätigt werden. Es basiert auf dem `gitcrawl`-Backend und einem `gh`-Shim, der viele Leseoperationen (Issues, PRs, CI-Runs) aus einem lokalen Cache bedienen kann, ohne die Anzahl der Live-API-Aufrufe zu erhöhen. Das Ziel ist es, GitHub-Rate-Limits zu vermeiden und die Effizienz von Agenten-Workflows zu steigern. Das Skill beschreibt die Standardpfade, Bedingungen für Live-Aufrufe (Schreibvorgänge, aktuelle Statusüberprüfungen), die Nutzung von `gh xcache` zur Cache-Inspektion und klare Agentenregeln, wie z. B. das Bündeln von Abfragen und das Vermeiden von Caching-Umgehungen. Es ist speziell für Peter's Maschinen konfiguriert, aber die Prinzipien sind allgemein anwendbar.

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

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht github-cache-hygiene?

Ziel: Häufige GitHub-Leseanfragen zuerst über gitcrawl und den gh-Shim beantworten; Live-API-Aufrufe nur dort verwenden, wo Aktualität oder Schreibzugriffe wichtig sind.

Standardpfad

gh normal verwenden. Auf Peters Maschinen ist davon auszugehen, dass dies der gitcrawl-gestützte Shim ist, sodass unterstützte Lesevorgänge ohne Befehlsänderung lokal oder zwischengespeichert beantwortet werden können.

Diese lokalen/zwischengespeicherten Lesevorgänge bevorzugen:

gitcrawl sync owner/repo --numbers 123 --with pr-details
gh search issues "<Begriffe>" -R owner/repo --state open --json number,title,state,url,updatedAt,labels,author
gh search prs "<Begriffe>" -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 branch-name --json databaseId,workflowName,status,conclusion,url
gh pr diff 123 -R owner/repo --patch

Exakte Refs und enge Felder verwenden. Breite Schleifen wie ein einzelnes gh issue view pro Ergebnis vermeiden, wenn ein einzelner gh search oder gh issue list --json ... die erste Frage beantworten kann.

Für CI: Vermeide enge gh run list/gh run view Polling-Schleifen. Nach einem Push oder Workflow-Dispatch identifiziere einen exakten Run und frage ihn mit Backoff ab. Vollständige Logs nur für fehlgeschlagene Jobs oder wenn der Benutzer explizit nach Logs fragt, abrufen. Abgeschlossene gh run view --log, --log-failed und gängige REST-Log-Endpunkte werden von gitcrawl länger zwischengespeichert, während der Run-Status kurzlebig bleibt.

Aktualität

Lokale Antworten eignen sich für Entdeckung, Duplikatsuche, Überprüfung alter Threads, Autor/Label-Triage und Überprüfungen „Gibt es wahrscheinlich bereits ein Issue/PR?“.

Verwende einen Live-Aufruf, wenn:

  • Schreiben, Kommentieren, Schließen, Zusammenführen, Neuausführen oder Bearbeiten
  • Überprüfung des endgültigen aktuellen Status vor einer Maintainer-Aktion
  • Überprüfung des CI-Status nach einem Push
  • das lokale Ergebnis fehlt oder offensichtlich veraltet ist
  • der Benutzer nach dem neuesten/aktuellen Zustand fragt

Für PR-Reviews: Bevorzuge das genaue Hydrieren von PR-Details einmalig mit gitcrawl sync owner/repo --numbers <n> --with pr-details, wenn bekannt ist, dass Dateien, Commits, Checks oder Run-Zusammenfassungen wiederholt überprüft werden. Der gh-Shim kann bei Fehltreffer automatisch einen exakten PR hydrieren, indem er GITHUB_TOKEN oder gh auth token verwendet; explizite Hydrierung macht Absicht und Kosten klarer.

Nach einem Schreibvorgang: Ein zielgerichtetes Rücklesen, kein breites Rescan.

XCache

Überprüfe das Cache-Verhalten bei Verdacht auf Ratenbegrenzungen:

gh xcache stats
gh xcache keys
gh xcache gc

backend_misses_by_command und backend_misses_by_route in gh xcache stats --json lesen, bevor neue Live-GitHub-Schleifen hinzugefügt werden. Diese Maps zeigen, welche Befehlsformen den Cache noch umgehen.

gh xcache flush nur verwenden, wenn eine veraltete zwischengespeicherte Fallback-Lesevorgang eine Entscheidung beeinträchtigt.

Für einen rein lokalen Nachweis kann das Backend vorübergehend für einen einzelnen Befehl deaktiviert werden:

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

Agenten-Etikette

Fragen nach Repository und Status bündeln. Bereits in der Sitzung ausgegebene Daten wiederverwenden. CI-Polling zurückfahren; Logs nur für fehlgeschlagene Runs oder den genauen Run unter Überprüfung einsehen. Den Shim nicht mit /opt/homebrew/opt/gh/bin/gh umgehen, es sei denn, der Shim selbst wird diagnostiziert.

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.

Verwandte Skills