mcpField
C
cache-expert

cache-expert

github.com/dagger開発16.5k56 回インストール今日更新
リポジトリ

cache-expert について

cache-expertは、Dagger Engineのキャッシュを調査、デバッグするためのスキルです。GraphQL APIが不変操作のDAGとしてワークフローを実行する仕組みを説明し、最新のリファレンスとキャッシュスナップショットをオフライン分析するGoスクリプトを案内します。

主な機能

  1. 01Daggerキャッシュアーキテクチャの概要
  2. 02キャッシュ調査用リファレンス
  3. 03デバッグとCIトレースの手順
  4. 04キャッシュスナップショット分析スクリプト

活用シーン

  1. 01保持されたキャッシュルートとクロージャの調査
  2. 02Daggerのキャッシュ動作のデバッグ
  3. 03キャッシュスナップショットダンプのオフライン分析

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dagger/dagger --skill cache-expert

インストール後、Claude Code で/cache-expertを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
cache_persistence.md
cache_pruning.md
cachebasics.md
dagqltypes.md
debugging.md
dynamicinputs.md
egraph.md
filesync.md
lazy_evaluation.md
mutablecache.md
session_resources.md
typedefs.md
writingcoreapis.md
scripts/
dagql-cache-analyzer.go

詳細

キャッシュの専門知識

高レベルアーキテクチャ

Dagger Engine は、DAG ワークフローを構築して実行するための GraphQL ベースの API を提供します。

各操作は、変更不可能なオブジェクトまたはスカラー値を入力として受け取り、変更不可能なオブジェクトまたはスカラー値を出力します。関数型プログラミングと同様に、変更不可能な値に対するこれらの操作の DAG によって「変更可能性」をシミュレートします。

入力が変更不可能で、操作が決定論的であるため、操作とその入力からキャッシュキーを導出できます。これにより、キャッシュが可能になります。

操作の DAG は ID としてシリアライズでき、各 ID には操作のキャッシュキーとして機能するダイジェストが関連付けられています。

references/ のリファレンスドキュメントは最新の状態であり、キャッシュ、永続化、プルーニング、遅延評価、セッションリソース、ファイル同期、型定義、e-graph の動作を理解するための現行のガイダンスとして扱う必要があります。コードが最終的な真実の源ですが、リファレンスドキュメントは現行の実装と一致していることが期待されています。

デバッグするキャッシュ領域に関連するリファレンスドキュメントは、必ず読んでください。広範なキャッシュ調査では、すべてのドキュメントを読んでください。references/debugging.md には、テストの実行、CI トレースの再生、および一般的なデバッグに関する重要な手順が記載されています。

スクリプト

  • scripts/dagql-cache-analyzer.go /debug/dagql/cache のスナップショットダンプをオフラインで解析し、保持された ルート、結果カテゴリ、および累積クロージャーのおおよその規模を要約します。

    使い方：

    go run ./skills/cache-expert/scripts/dagql-cache-analyzer.go /tmp/dagql.cache.1

コメント

Markdown 対応