cache-expert

cache-expert 技能旨在為 Dagger Engine 的快取架構提供深入的技術洞察。Dagger 將建置與部署工作流視為不可變值操作的有向無環圖 (DAG)，且每個操作皆具備確定性。透過利用這種不可變性，引擎可直接從輸入與操作中衍生出快取鍵值。此技能專為需要診斷效能退化、非預期的快取失效或複雜管線結構中無效異常的工程師與平台開發者所設計。它作為理解 Dagger 如何將 DAG 序列化為內容定址 ID，以及如何解讀內部引擎診斷資訊的介面。

• 對 DAG 模型、不可變資料結構以及確定性操作執行進行專家級分析。

• 用於偵錯快取失效邏輯與解決 CI/CD 環境中非預期快取遺失的診斷工作流。

• 指導解讀 Dagger Engine 內部快取狀態，包含使用 dagql-cache-analyzer 工具來分析引擎快照轉儲 (snapshot dumps)。

• 支援基於 GraphQL API 與內部引擎狀態來實作或擴充快取相關的引擎功能。

• 洞察 Dagger 如何透過內容定址快取來自動化軟體交付，同時確保建置的可重複性。

• 專為使用 Dagger CLI 與引擎內部的開發者設計，特別是針對偵錯 CI 管線或優化建置效能的場景。

• 使用提供的 dagql-cache-analyzer 指令碼來處理 /debug/dagql/cache 快照轉儲，以進行離線檢查保留根節點與結果類別。

• 主要輸入包含引擎除錯日誌、快取快照與管線操作軌跡；輸出包含診斷摘要與效能優化策略。

• 請注意，內部引擎機制的說明文件可能處於實驗階段或已過時；原始碼與儲存庫中的 references/debugging.md 指南是真正的真理來源。

• 請留意快取行為從根本上與輸入的不可變性相關；外部副作用或非確定性輸入將導致快取中斷。