GitHub Actions Caching Strategies

概要

GitHub Actions のキャッシュ戦略を設計し、ヒット率とサイズを最適化する。 詳細は references/ に外部化し、必要時に参照する。

• キャッシュ例: assets/cache-examples.yaml

ワークフロー

Phase 1: キャッシュ対象の整理

目的: キャッシュ対象と制約を整理する

アクション:

1. references/Level1_basics.md で基本概念を確認
2. references/cache-action.md で actions/cache を確認
3. キャッシュ対象/頻度/制限を整理

Task: agents/analyze-cache-requirements.md

Phase 2: キー設計

目的: キーとパスを設計する

アクション:

1. references/cache-patterns.md を参照
2. キーに含める入力を整理
3. restore-keys の戦略を決定

Task: agents/design-cache-keys.md

Phase 3: 最適化と分割

目的: ヒット率とサイズを最適化する

アクション:

1. references/cache-optimization.md を参照
2. scripts/estimate-cache-size.mjs でサイズを見積もる
3. 分割/除外/レイヤー化方針を決定

Task: agents/optimize-cache-strategy.md

Phase 4: 検証と記録

目的: 効果を検証し記録する

アクション:

1. references/Level4_expert.md で監査観点を確認
2. ヒット率/速度改善を確認
3. scripts/validate-skill.mjs で構造検証
4. scripts/log_usage.mjs で記録

Task: agents/validate-cache-impact.md

Task仕様ナビ

ベストプラクティス

すべきこと

• キーの粒度を明確にする
• restore-keys を設定する
• 10GB制限を意識する
• 大きなキャッシュは分割する

避けるべきこと

• 変更頻度の高い入力をキーに含めすぎる
• ヒット率を測定しない
• キャッシュ肥大を放置する

リソース参照

参照資料

• references/Level1_basics.md: 基礎概念
• references/Level2_intermediate.md: 設計ガイド
• references/Level3_advanced.md: 最適化
• references/Level4_expert.md: 監査/計測
• references/cache-action.md: actions/cache 仕様
• references/cache-patterns.md: 言語別パターン
• references/cache-optimization.md: 最適化戦略
• references/legacy-skill.md: 旧版要約（移行時のみ）

スクリプト

• scripts/estimate-cache-size.mjs: サイズ見積り
• scripts/validate-skill.mjs: スキル構造検証
• scripts/log_usage.mjs: 実行ログ記録

テンプレート

• assets/cache-examples.yaml: キャッシュ設定例

変更履歴