netlify-caching

netlify-caching skill 概览

netlify-caching skill 可以帮助你控制内容在 Netlify 的 CDN 和浏览器中如何被缓存。它适用于你需要可预测的缓存头、stale-while-revalidate 行为、按需清除，或者面向 Deployment 工作流的框架特定缓存时。它的核心工作，是把“这个页面感觉很慢或已经过期”转化为一套与内容新鲜度、流量模式和部署流程相匹配的缓存策略。

这个 skill 用来做什么

这是一个实用的 netlify-caching 指南，帮助你判断哪些响应应该缓存、缓存在哪一层、缓存多久。它尤其适合静态资源、函数响应、edge 响应，以及那些会在 deploy 之后变化的内容。

最适合哪些读者

如果你正在 Netlify 上交付内容，并且希望少一些对 Cache-Control、Netlify-CDN-Cache-Control 和 CDN-Cache-Control 这些头的猜测，那么 netlify-caching skill 很适合你。它适用于想在不把敏感或变化很快的响应过度缓存的前提下，优化性能、SEO 或内容新鲜度的开发者。

主要区别

这个仓库关注的是 Netlify 特有的行为，而不是通用的 HTTP 缓存理论。这个区别很重要，因为 Netlify 的 CDN 可能会以不同方式处理静态资源、动态响应和 deploy 失效，所以正确的 netlify-caching install 关键在于匹配平台规则，而不只是给所有内容统一加一个头。

如何使用 netlify-caching skill

安装并先打开正确的源文件

先把这个 skill 安装到你的 Netlify context-and-tools 环境里，然后优先阅读 skills/netlify-caching/SKILL.md。由于这个仓库没有 helper scripts 或 reference folders，真正有价值的是 skill 本体：示例、头部顺序，以及默认行为说明。

把模糊目标改写成有效提示词

一个高质量的 netlify-caching usage 提示词，会明确响应类型、新鲜度目标和部署约束。例如：“为一个每天更新的营销页设置 CDN 缓存，但保留浏览器 revalidation，确保 deploy 安全。” 这样 skill 才有足够上下文来选择合适的头，并避免给出空泛建议。

带着正确的问题读仓库

先看默认行为、cache-control 头、常见模式和 immutable assets 相关部分。实际上，这些就是影响是否采用的关键判断点：内容是静态还是动态、浏览器是否应该 revalidate、以及 CDN 是否应该在刷新期间返回 stale 内容。

放进你的工作流里使用

当你需要在 Netlify-CDN-Cache-Control 和 Cache-Control 之间做选择，或者想要 stale-while-revalidate，但又不小心把不该缓存的内容缓存起来时，就该用这个 skill。对于 netlify-caching for Deployment，核心流程是：先识别 deploy 时会变化的内容，再为共享缓存设置 CDN 规则，浏览器行为则尽量保守，除非你有充分理由改变。

netlify-caching skill 常见问题

这只适合高级缓存场景吗？

不是。即使只是想让静态资源被正确缓存、同时让动态响应保持原样，netlify-caching skill 也很有用。等你需要分别控制浏览器和 CDN 行为时，它的价值会更明显。

它和普通提示词有什么不同？

普通提示词可能只是在泛泛讲缓存，而 netlify-caching guide 是围绕 Netlify 的头部优先级和 CDN 行为来调校的。这能降低看起来“正确”但在 Netlify 上实际表现不对的风险。

什么时候不该用它？

不要把 netlify-caching 当成内容建模或失效设计的替代品。如果真正的问题是你的应用重写数据太频繁，或者页面建立在无法缓存的个性化内容之上，那么只靠缓存头并不能解决架构问题。

它适合第一次使用 Netlify 的人吗？

适合，只要你想走一条聚焦的缓存决策路径。这个 skill 的范围足够窄，能帮助新手避免过度复杂化，但你仍然需要知道应用里哪些部分是静态的、动态的，或对 deploy 敏感。

如何改进 netlify-caching skill

先把响应形态说清楚

最好的输入会直接说明返回的是什么：HTML page、API response、edge function output、image asset，还是 proxy response。这一点很重要，因为 netlify-caching 的选择会随响应类型变化；模糊请求通常只会得到泛泛的头部建议。

说明新鲜度要求和容错范围

如果你想获得更好的 netlify-caching usage，就要明确内容可以有多旧。例如：“revalidation 期间允许旧内容保留 2 分钟”要比“稍微缓存一下”有用得多。这样 skill 才能在短 TTL、stale-while-revalidate 和更严格的 no-store 行为之间做出更准确的选择。

说明哪些内容必须跨部署保留

对于 netlify-caching for Deployment，要说清楚 deploy 是应该清空全部内容，还是只影响某些资产。如果你有 immutable files、版本化 bundles，或者应该在 publish 时清除的内容，最好一开始就说出来。这样可以避免缓存规则过宽，把更新遮住。

从第一次结果继续迭代

如果第一次回答太泛，就用真实的 header 目标再加一个约束来细化，比如浏览器 revalidation、仅 CDN 缓存，或者 purge 要求。最好的 netlify-caching skill 输出来自精准输入，而不是抽象地问“最好的缓存方式是什么”。