workers-best-practices 是 Cloudflare 用于编写和审查 Workers 代码的 Skill。它指导 AI 检查请求处理、异步任务、配置、密钥和日志,适合接口已经能跑、准备进一步核对实现的开发者。
例如,把某个请求的数据存在模块级变量里,可能影响后续请求;响应返回以后还需要继续的工作,也要交给合适的机制管理,不能随手启动一个异步调用就不管了。
大体积或未知大小的响应是另一个检查点。文档要求考虑流式处理,避免为了方便一次读入全部内容。配置中的绑定也应与代码保持一致,密钥不能直接写进源码。
它要求先取得当前文档、类型和配置规则,再看完整文件并提供证据。你拿到的应该是与具体实现对应的问题或修改,版本不确定的地方先查,不能靠 AI 对旧接口的记忆下结论。