Community研究&データ分析github.com

steipete/github-cache-hygiene

GitHub クォータ/キャッシュ管理: gh, ghx, xcache, gitcrawl, ミラー, 制限対応

github-cache-hygiene とは?

GitHub Cache Hygiene は、GitHub API のレート制限(クォータ)を節約し、応答を高速化するために設計された AI エージェントスキルです。gitcrawl によるローカルキャッシュや gh のシャム(シム)を活用し、まずはキャッシュから情報を取得し、書き込みや最新状態の確認が必要な場合にのみライブの GitHub API 呼び出しを行います。このスキルは主に Peter の環境で動作し、gh コマンドを透過的にシャムに置き換えることで、使い慣れたコマンド体系を変えずに読み取り処理の大部分をローカルで完結できます。サポートするプラットフォームは Claude Code であり、具体的な使い方として、`gitcrawl sync` でリポジトリのデータを同期後、`gh search issues` や `gh issue list` など標準的な gh コマンドを実行するだけです。また、`gh xcache stats` でキャッシュのヒット率や未キャッシュのコマンドを確認でき、`gh xcache flush` でキャッシュをクリアする機能も備えています。CI のポーリングを避け、バックオフ戦略で実行状況を確認するなど、エージェントとしてのマナーも重視しており、大規模な API コールの繰り返しを防ぐためのベストプラクティスがまとめられています。

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

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

GitHub Cache Hygiene

目標:gitcrawl と gh シャムから一般的な GitHub 読み取り質問にまず回答し、新鮮さや書き込みが必要な場合にのみライブの GitHub API 呼び出しを使用する。

デフォルトパス

通常の gh を使用する。Peter のマシンでは、gitcrawl をバックエンドとするシャムが期待されているため、対応する読み取りはコマンドを変更せずにローカルまたはキャッシュから回答できる。

以下のローカル/キャッシュ読み取りを優先する:

gitcrawl sync owner/repo --numbers 123 --with pr-details
gh search issues "<terms>" -R owner/repo --state open --json number,title,state,url,updatedAt,labels,author
gh search prs "<terms>" -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

正確な参照(ref)と狭いフィールドを使用する。gh issue view を結果ごとに繰り返すような広範なループは避け、単一の gh search や gh issue list --json ... で最初の質問に回答できるようにする。

CI では、gh run list / gh run view のタイトなポーリングループを避ける。プッシュまたはワークフローのディスパッチ後、1 つの正確な実行を特定し、バックオフをかけてポーリングする。完全なログは、失敗したジョブまたはユーザーが明示的にログを要求した場合のみ取得する。完了済みのスタイル(gh run view --log、--log-failed、および一般的な Actions REST ログエンドポイント)は gitcrawl によってより長くキャッシュされるが、実行ステータスは短寿命のままである。

新鮮さ(Freshness)

ローカルの回答は、発見、重複検索、過去のスレッドレビュー、作成者/ラベルのトリアージ、「既に issue/PR がある可能性は?」の確認に適している。

ライブ呼び出しは次の場合に使用する:

  • 書き込み、コメント、クローズ、マージ、再実行、編集
  • メンテナーアクションの前に最終的な現在状態を確認する場合
  • プッシュ後の CI ステータスを確認する場合
  • ローカル結果が欠落しているか明らかに古い場合
  • ユーザーが最新/ライブ状態を要求した場合

PR レビューでは、ファイル、コミット、チェック、実行サマリーを繰り返し確認することがわかっている場合、gitcrawl sync owner/repo --numbers <n> --with pr-details で正確な PR 詳細を一度ハイドレートすることを推奨する。gh シャムは、GITHUB_TOKEN または gh auth token を使用して、ミス時に 1 つの正確な PR を自動ハイドレートできるが、明示的なハイドレーションにより意図とコストが明確になる。

書き込み後は、広範な再スキャンではなく、1 回の対象を絞った読み戻し(readback)を行う。

XCache

レート制限が疑われる場合にキャッシュ動作を検査する:

gh xcache stats
gh xcache keys
gh xcache gc

新しいライブ GitHub ループを追加する前に、gh xcache stats --json の backend_misses_by_command と backend_misses_by_route を読む。これらのマップは、どのコマンド形状がまだキャッシュから逃れているかを示す。

gh xcache flush は、古いキャッシュフォールバック読み取りが判断を誤らせている場合にのみ使用する。

ローカルのみの証明として、一時的にバックエンドを単一のコマンドで利用不可にする:

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

エージェントのマナー(Agent Etiquette)

リポジトリと状態ごとに質問をまとめる。セッション中に既に出力されたデータを再利用する。CI のポーリングは控えめにし、ログは失敗した実行またはレビュー中の正確な実行についてのみ検査する。シャム自体の診断以外では、/opt/homebrew/opt/gh/bin/gh でシャムをバイパスしない。

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.

関連スキル