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 指南是真正的真理来源。

• 请留意缓存行为从根本上与输入的不可变性相关；外部副作用或非确定性输入将导致缓存中断。