开发与工程

Cloudflare Durable Objects 构建指南

帮助代理构建和审查 Cloudflare 上的有状态协调应用。

48/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 3.1k
最近更新
13 天前
License
Apache-2.0
cloudflaredurable-objectsworkerssqlite
+2websocketsvitest

这个 Skill 能做什么,适合哪些场景?

这是 cloudflare/skills 仓库中的 Durable Objects 专用 Agent Skill,面向在 Cloudflare Workers 边缘环境构建有状态应用。它覆盖 Durable Objects 类、RPC、SQLite 存储、闹钟、WebSocket、Wrangler 配置以及 Vitest 测试。该 Skill 强调优先检索 Cloudflare 官方文档,以降低 API 和配置过时的风险。它适合需要强一致性、实体级持久化或持久连接的开发场景,不适合无状态请求处理或高 fan-out 的独立请求。

指导代理创建和审查 Durable Objects 类,设计按聊天房间、游戏或用户划分的协调模型,配置 wrangler.jsonc/toml 中的绑定与迁移,编写 RPC、SQLite、KV、闹钟和 WebSocket 相关代码,并使用 @cloudflare/vitest-pool-workers 编写测试。执行任务时,它建议检索 Durable Objects 文档、API 参考、最佳实践和示例页面。它还提供存根创建、存储操作、闹钟和测试的 TypeScript 示例。

适合
  • 开发者为聊天房间、多人游戏或协作文档设计一个按实体协调的 Durable Object。
  • Cloudflare Workers 项目需要通过 RPC 方法、WebSocket 或闹钟实现实时或定时逻辑。
  • 团队需要配置 Durable Objects 绑定、SQLite 迁移和 Wrangler 项目设置。
  • 开发者审查现有 Durable Objects 代码中的并发、持久化、分片或父子关系设计。
  • 开发者使用 @cloudflare/vitest-pool-workers 为 Durable Objects 编写单元或集成测试。

如何安装这个 Skill?

使用前请注意
  • 执行前应核对当前 Cloudflare Durable Objects API、兼容日期、Wrangler 配置和 Vitest 依赖版本。
  • 不要直接采用示例中的开放 CORS 或生产部署命令;应先确认授权、环境、数据访问范围和回滚方案。
  • 核心资料检索依赖 Cloudflare 海外站点,需确认中国大陆网络可达性并准备离线或镜像资料。
开始前你需要
Agent 需要具备
  • 网络访问
  • 本地文件系统

该仓库支持 Agent Skills 标准。使用 npx skills add https://github.com/cloudflare/skills 安装整个集合;若使用 OpenAI Codex,可将 skill 文件夹复制到 ~/.codex/skills/。也可以克隆仓库后,将 skills/durable-objects 文件夹复制到所用代理的技能目录。源材料未说明单独安装此技能的专用命令。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/cloudflare/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/durable-objects" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 创建一个使用 SQLite 和 RPC 的 Cloudflare Durable Object 聊天室,并为它编写 Vitest 测试。

在代理对话中提出与 Durable Objects 相关的任务,例如:“创建一个使用 SQLite 和 RPC 的 Cloudflare Durable Object 聊天室,并为它编写 Vitest 测试。”匹配触发条件后,代理会加载该技能;实现功能时应检索相关 Cloudflare 文档页面。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖从 Workers 集成、Wrangler 配置到存储、RPC、闹钟和测试的完整 Durable Objects 工作流。
  • 提供可直接参考的 TypeScript 配置、实现和测试示例。
  • 明确说明协调粒度、持久化优先和并发控制等关键规则与反模式。
  • 采用检索优先取向,适合 API 可能变化的 Cloudflare 开发任务。
局限
  • 范围仅限 Durable Objects,不覆盖仓库中的其他 Cloudflare 技能。
  • 需要访问 Cloudflare 文档以获取最新 API 和配置依据。
  • 源材料没有提供独立的自动化测试结果或版本兼容矩阵。
  • 示例依赖 Cloudflare Workers、Durable Objects 和 Vitest 相关开发环境,但未给出完整项目脚手架。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Cloudflare Durable Objects 构建指南 本页 48 · 谨慎使用 ★ 3.1k 13 天前 Apache-2.0
Cloudflare Agents SDK 构建指南 49 · 谨慎使用 ★ 3.1k 13 天前 Apache-2.0
Cloudflare 邮件服务技能 52 · 谨慎使用 ★ 3.1k 13 天前 Apache-2.0
Engram 持久记忆协议 68 · 推荐 ★ 7.2k 13 天前 MIT
DeepChat 数据导入技能 62 · 推荐 ★ 6.4k 15 天前 Apache-2.0

与普通的无状态 Cloudflare Workers 相比,该 Skill 专注于需要协调、强一致性、实体级存储、持久连接或按实体调度任务的 Durable Objects 场景;对于纯无状态请求处理,源材料建议使用普通 Workers。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
48/ 100 五分制 2.4 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全14 / 25 · 2.8/5

内容主要是开发指导,未见恶意行为、凭据窃取或隐蔽外传;但未规定最小权限、用户确认、数据流披露、敏感数据边界、部署回滚或外部副作用控制,且示例包含开放 CORS 和生产部署命令,因此扣分。

2可靠稳定7 / 20 · 1.8/5

结构一致,覆盖 DO、SQLite、RPC、告警、WebSocket、测试和错误处理,且失败处理有基本说明;但仅为静态文档,未提供针对关键路径的已提交测试套件,部分示例和依赖版本可能随 Cloudflare API 变化,异常输入与诊断覆盖有限,按静态上限保守扣分。

3适用触发10 / 15 · 3.3/5

受众、使用场景和若干不适用场景较清晰,包含 Workers、Wrangler 和 Vitest 环境;但没有精确的触发排除规则、输入输出契约或中文支持,核心检索依赖 Cloudflare 海外文档,未证明中国大陆网络可达,因此扣分。

4规范维护8 / 15 · 2.7/5

采用主文档加 references 分层,包含配置、测试、限制、示例和 Apache-2.0 许可证;但缺少技能自身的版本、变更日志、维护责任人、更新路径、FAQ 和完整安装说明,发布者身份也未验证,因此扣分。

5有效结果6 / 15 · 2.0/5

可直接指导常见 Durable Objects 实现,提供可复制的配置、代码模式、测试样例和反模式,核心任务价值明确;但没有静态可确认的真实产出或执行验证,且检索、版本适配和示例正确性仍需用户复核,按静态上限不超过 7 分。

6证据核验3 / 10 · 1.5/5

提供 Cloudflare 文档、API、最佳实践和示例链接,并有 Semgrep CI 配置这一有限的仓库证据;但没有针对该技能关键路径的提交测试或第三方执行结果,无法独立复现结论,因此仅给有限分数。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 70215303d44a 评估证据[1][2][3][4][5][6][7]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个 Skill 是否会替我部署 Cloudflare 应用?
源材料只说明它提供构建、配置、审查和测试指导,没有说明会自动部署应用。
什么时候不应采用 Durable Objects?
如果需求是无状态请求处理、最大化全球分布,或大量彼此独立的高 fan-out 请求,源材料不建议使用 Durable Objects。
它如何处理 Durable Objects API 可能过时的问题?
它建议优先检索 Cloudflare Durable Objects 文档、API 参考、最佳实践和示例页面,而不是只依赖预训练知识。

同仓库的其他 Skills

均来自 cloudflare/skills

开发与工程

Cloudflare Agents SDK 构建指南

帮助开发者在 Cloudflare Workers 上构建具备持久状态、实时通信和可靠后台执行能力的 AI Agent。

★ 3.1k FS 49 谨慎使用 13 天前
开发与工程

Cloudflare 邮件服务技能

帮助智能体在 Cloudflare 上配置并实现事务性邮件收发与邮件路由。

★ 3.1k FS 52 谨慎使用 13 天前
开发与工程

Workers 生产实践审查

按最新 Cloudflare 资料审查并编写可上线的 Workers 代码。

★ 3.1k FS 57 谨慎使用 13 天前
开发与工程

Cloudflare Wrangler 部署助手

帮助代理可靠地使用 Wrangler 构建、开发、部署和管理 Cloudflare Workers。

★ 3.1k FS 49 谨慎使用 13 天前
开发与工程

Cloudflare Sandbox 构建助手

帮助代理在 Cloudflare Workers 上构建安全的隔离代码执行环境。

★ 3.1k FS 46 谨慎使用 13 天前
开发与工程

Cloudflare 平台开发技能

帮助代理检索资料并构建 Cloudflare 应用。

★ 3.1k FS 45 不推荐 13 天前
自动化与运维

Cloudflare One 迁移规划师

将 Zscaler、Palo Alto、传统 VPN、SWG 或 SASE 迁移规划为可验证的 Cloudflare One 方案。

★ 3.1k FS 58 推荐 13 天前
自动化与运维

Cloudflare One 零信任架构顾问

帮助代理设计、配置和排查 Cloudflare One 部署。

★ 3.1k FS 55 谨慎使用 13 天前
开发与工程

Turnstile 全链路接入助手

为现有表单完成 Cloudflare Turnstile 的前端嵌入、后端校验与验证。

★ 3.1k FS 54 谨慎使用 13 天前
开发与工程

网页性能审计

用 Chrome DevTools MCP 定位网页加载、核心体验指标和可访问性问题。

★ 3.1k FS 43 不推荐 13 天前

相关 Skills