1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | durable-objects-cloudflare-skills | — |
| 作者/维护者 | Cloudflare, Inc. 官方仓库 cloudflare/skills，主要贡献者可查证为 Cloudflare 员工（如 Matt Silverlock / elithrar） |
GitHub API（repo + commits） |
| 来源链接 | https://github.com/cloudflare/skills/tree/main/skills/durable-objects | — |
| 许可证 | Apache-2.0（仓库根 LICENSE 声明） | GitHub API |
| GitHub Stars / Forks | 所属仓库 2,508★ / 236 forks（该数字属整个合集仓库，不代表本子技能个体热度；子技能自身证据见第 6 章） | GitHub API |
| 最新版本 | 无独立版本号；该子目录最近一次专属改动提交于 2026-03-03 | GitHub API（commits） |
| 安装方式 | Claude Code 插件市场一条命令 / npx skills / 克隆后手动复制子目录 |
仓库 README |
2. 功能介绍与亮点
durable-objects 是一份教 Agent 正确使用 Cloudflare Durable Objects 构建有状态协调服务的参考技能。核心覆盖：
- 何时该用 / 不该用 DO：聊天室、多人游戏、预定系统、多租户 SaaS 等需要强一致性与按实体持久化的场景用 DO；纯无状态请求处理、最大化全球分布式场景不用 DO，正文用对照表逐条列出。
- 完整技术要点：
getByName()确定性路由、SQLite 存储与 KV 存储两种模式、blockConcurrencyWhile()初始化陷阱、alarm 调度、RPC 方法（而非 fetch handler）、wrangler.jsonc 迁移配置，均附可运行的 TypeScript 代码示例。 - 反模式清单：单一全局 DO 造成瓶颈、每次请求都调用
blockConcurrencyWhile()拖垮吞吐、跨await破坏存储原子性等 5 类常见错误逐条列出。 - 配套三份参考文档：
references/rules.md（295 行）、testing.md（264 行，Vitest 单元/集成/alarm 测试）、workers.md（346 行，Workers 集成与 wrangler 配置），主文件加参考文档合计逾 900 行。
亮点：官方 Cloudflare 出品，明确要求“优先从官方文档页面检索而非依赖预训练知识”，并列出 4 个具体文档链接；仓库整体保持活跃（近一周内仍有提交）。
3. 适用场景
固定分类：DevOps 与基础设施。
面向已在使用 Cloudflare Workers、需要为聊天室、多人游戏、预定系统等场景实现有状态协调服务的开发者。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——README 提供
/plugin marketplace add cloudflare/skills+/plugin install cloudflare@cloudflare一条龙安装，含 durable-objects。 - Codex：✅ 官方 README 将 OpenAI Codex 列入支持列表（
~/.codex/skills/）；但需注意第三方 issue #85（用户 lygris）具体指出该仓库包括 durable-objects 在内的多个技能在 Codex 环境下存在描述路由重叠问题，实际使用时可能出现多技能同时触发。 - OpenClaw：❓ 未验证——README 未点名，仅提供通用“克隆后手动复制到对应目录”方式，理论上可行但无官方声明。
- Hermes Agent：❓ 未验证——同上。
（结论仅基于已抓取的仓库 README、SKILL.md 及相关 issue 原文，未为兼容性单独发起额外搜索。）
5. 推荐理由
这是 Cloudflare 官方对 Durable Objects 这一边缘有状态计算原语的权威参考：不仅讲清“什么时候该用”，还系统列出反模式、存储原子性陷阱与测试方法，主文件加三份参考文档逾 900 行内容深度扎实；技能本身是纯指令文档，无脚本执行、无凭据索取，安装单元透明可审计，适合正在 Cloudflare Workers 上构建有状态服务的开发者作为标准参考手册。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 所属合集仓库 2,508★ 不代表本子技能个体热度，改看子目录自身证据：至少 3 位独立第三方 GitHub 用户有实际互动——hiendaovinh 提交过一次修复 SQLite schema 处理方式的 PR（#12），lygris（issue #85）与 baoyu0（issue #84）分别报告了该技能在 Codex 及第三方 Skill 管理工具中的具体兼容性问题，属实质性第三方参与而非泛泛提及 |
| 可用性 | 8 | SKILL.md 加 3 份参考文档合计逾 900 行、含可运行代码示例；除插件市场一条命令外还提供 npx skills 与手动复制两条备选安装路径；仓库整体每周仍有提交，但该子技能自身最近一次专属改动约在 5 个月前，未落在最近 3 个月窗口内 |
| 安全性 | 9 | 检查清单详见下表 |
安全检查清单：
- ① 是否执行 shell 命令及权限范围：技能本身不执行任何 shell 命令，仅提供代码示例文本
- ② 运行时是否联网外发数据：唯一网络行为是引导 Agent 主动查阅 Cloudflare 官方公开文档页面，不涉及用户数据外发
- ③ 是否要求 API key/凭据及其存储方式：技能本身不索取任何凭据（实际部署 Durable Objects 需要 Cloudflare 账号与 wrangler 登录，但这属于 Cloudflare 平台本身的前置条件，不是本技能索取的）
- ④ SKILL.md 与附带脚本中有无可疑指令：全文纯 Markdown + 代码示例，无附带可执行脚本，逐行审阅未见混淆代码或 prompt injection 迹象
- ⑤ 作者/组织信誉：Cloudflare, Inc. 官方组织仓库，主要提交者可查证为 Cloudflare 员工
- ⑥ License 是否明确：明确，Apache-2.0
- ⑦ 最近维护时间：仓库整体一周内仍有提交，非弃置项目
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
temporalio/skill-temporal-developer（199★，MIT，Temporal 官方出品） |
面向“工作流即代码”的持久化执行编排引擎，跨语言、跨云或可自托管部署 | 需要额外部署 Temporal Server 或使用 Temporal Cloud 才能运行；本技能对应的 Durable Objects 原生绑定 Cloudflare Workers 运行时，无需部署额外的编排服务 |
get-convex/agent-skills（41★，Convex 官方） |
面向 Convex 响应式 TypeScript 后端函数与内置实时数据库的全托管 BaaS 平台 | 是一整套后端即服务方案，覆盖数据库到函数运行时；本技能聚焦的是 Cloudflare 平台内一个具体的有状态计算原语（按实体粒度的 actor 模型），职责边界更窄但与 Workers 生态集成更紧密 |
Cloudflare 同仓库 agents-sdk 技能 |
面向在 Durable Objects 之上构建完整 AI Agent（含调度、RPC、MCP Server、流式对话）的高层框架 | 是建立在 Durable Objects 之上的更高层抽象，面向“造 AI Agent”；本技能讲的是更底层的 DO 类本身如何正确建模、存储与测试，是前者的基础前置知识 |
8. 用户评价
该技能作为合集仓库的一部分，第三方对其单独的具名评价文本较少；可查证的第三方技术互动包括：GitHub 用户 lygris 在仓库 issue #85 中具体指出该技能与仓库内其他 Cloudflare 技能在 OpenAI Codex 环境下存在描述路由重叠问题；GitHub 用户 baoyu0 在 issue #84 中报告该技能在第三方 Skill 管理工具（~/.pi/skills/）里与用户本地副本发生路径冲突。两者均为具体的技术问题报告，如实呈现。
9. 其他补充
同仓库内另有 agents-sdk、sandbox-sdk、wrangler、web-perf、workers-best-practices 等 10 个子技能覆盖 Cloudflare 开发的不同侧面，与本技能形成互补的完整工具箱；仓库不设版本号系统性升级机制，改动直接体现在提交历史中。
10. 安装使用方式
方式一：Claude Code 插件市场（推荐）
/plugin marketplace add cloudflare/skills
/plugin install cloudflare@cloudflare该命令会连带安装同仓库全部 Cloudflare 技能，包括 durable-objects。
方式二：npx skills 通用安装器
npx skills add https://github.com/cloudflare/skills方式三：手动复制
克隆仓库后，将 skills/durable-objects 文件夹复制到对应 Agent 的技能目录（如 Claude Code 的 ~/.claude/skills/）。
安装后无需重启；技能基于 SKILL.md 的 description 字段自动匹配触发，当对话涉及 Durable Objects、有状态协调、RPC、alarm 等话题时会被自动加载，无需手动调用。
11. 注意事项
该技能仅覆盖 Durable Objects 本身的用法，不含 Cloudflare 账号注册、wrangler CLI 安装等前置环境搭建；作为插件市场方式安装时会连带装入其余 10 个 Cloudflare 技能；OpenClaw、Hermes Agent 暂无官方兼容性声明；已知有第三方在 OpenAI Codex 环境下报告过该技能与仓库内其他技能的描述路由重叠问题，多技能同时触发时建议留意上下文占用。