1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | agents-sdk-cloudflare-skills |
| 项目自述名称 | Cloudflare Skills（仓库 README 标题；子技能自身 name 字段为 “agents-sdk”） |
| 作者/维护者 | Cloudflare，GitHub 官方组织 cloudflare |
| 来源链接 | https://github.com/cloudflare/skills/tree/main/skills/agents-sdk |
| 许可证 | Apache-2.0（GitHub API 取数，仓库级） |
| GitHub Stars | 2,173（GitHub API 取数，2026-07-16；注：该数字属 cloudflare/skills 整个合集仓库，不代表本技能自身热度） |
| Forks | 207（GitHub API 取数，同上口径） |
| 最新版本 | 未获取——仓库未使用 GitHub Releases/Tag 发版，采用持续提交式发布 |
| 安装方式 | Claude Code 插件市场一条命令安装，或 npx skills / 手动复制 |
2. 功能介绍与亮点
agents-sdk 是 Cloudflare 官方合集仓库 cloudflare/skills 中的技能，教 Agent 在 Cloudflare Workers 平台上构建具备持久状态的 AI Agent：
- 状态与持久化：基于 SQLite 的内置状态存储，
setState()自动同步到客户端 - RPC 通信：
@callable()装饰器暴露可通过 WebSocket 直接调用的方法 - 任务调度：
schedule()支持一次性、周期性与 cron 任务 - 持久工作流：
runWorkflow()/runFiber()支持跨基础设施驱逐仍能存活的多步后台任务 - 队列与重试：内置 FIFO 队列与指数退避重试机制
- 对话与集成：支持流式聊天 Agent、工具调用、消息持久化；可对接或搭建 MCP Server；支持邮件路由与外部 Webhook
亮点：官方一线基础设施厂商出品；Apache-2.0 完全开源可审计；README 明确列出与 Claude Code、OpenAI Codex 等多个 Agent 生态的兼容安装方式；仓库整体持续维护（2026-07-13 仍有提交）。
3. 适用场景
所属分类：DevOps 与基础设施
面向希望用 AI 编码 Agent 直接在 Cloudflare Workers 上“构建 Agent 本身”的初中级工程师：无论是做一个带记忆的聊天机器人、需要定时任务的自动化流程，还是需要跨设备状态同步的协作应用，该技能都提供了官方推荐的状态管理、RPC 与调度模式，避免 Agent 因训练知识过期而虚构 SDK 用法。
4. 跨 Agent 兼容性
README 明确写明：cloudflare/skills 中的技能 “works with any agent that supports the Agent Skills standard, including Claude Code, OpenCode, OpenAI Codex, and Pi.”
- Claude Code：原生支持——README 提供专门的插件市场安装命令
/plugin marketplace add cloudflare/skills，并列出~/.claude/skills/作为通用安装目录 - Codex：原生支持——README 明确列出 OpenAI Codex 及其技能目录
~/.codex/skills/ - OpenClaw：未验证——材料未提及；SKILL.md 采用通用 Agent Skills 标准格式，理论上可移植，但未见官方测试或适配声明
- Hermes Agent：未验证——同上，材料未提及
5. 推荐理由
Cloudflare Workers 正在成为构建低延迟、全球分布式 AI Agent 的热门底座，但 Agents SDK 的状态管理、RPC、调度等 API 迭代较快，通用编码 Agent 容易凭训练记忆虚构过期用法。这份官方技能把状态持久化、WebSocket RPC、任务调度、工作流等核心模式直接写进 Agent 操作规范，是目前唯一聚焦“在 Cloudflare 上构建 Agent 本身”这一细分场景的官方技能，对既用 Claude Code / Codex 写代码、又想亲手搭一个 Agent 产品的初中级工程师很有针对性。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 官方一线基础设施厂商（Cloudflare）出品；README 明确的多 Agent 生态兼容声明；InfoQ 等科技媒体报道过 Cloudflare 同期 Agent Skills 计划（Cloudflare One 技能栈）；但未找到针对 agents-sdk 本身的 Reddit/HN 独立讨论帖 |
| 可用性 | 8 | 一条命令安装（Claude Code 插件市场 / npx skills）；SKILL.md + references 参考文档结构清晰，含官方 npm 包（agents、@cloudflare/ai-chat 等）与代码示例；子目录路径最后提交 2026-04-15，距今约 3 个月，略逊于同仓库旗舰技能的近 1 个月维护频率 |
| 安全性 | 9 | 见下表 |
| 综合评分 | 8.3 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ①Shell 命令执行范围 | 技能本身为文档/参考资料，不含可执行脚本；实际部署经由用户本机的 wrangler CLI 完成，需用户主动触发 |
| ②运行时联网外发 | Agent 构建的应用本身会产生 WebSocket/RPC 等网络通信，这是 SDK 功能所需且在文档中透明说明，未见隐蔽外发目标 |
| ③API Key/凭据存储 | 文档未要求存储明文凭据；MCP Server 场景使用 OAuth，WebSocket 通信使用 token 鉴权，账号层面的 Cloudflare API Token 由用户自行管理 |
| ④可疑指令/注入迹象 | 抓取的 SKILL.md 中未发现要求执行未授权操作的指令；唯一的强约束提示是技术性的（“不要在 tsconfig 中开启 experimentalDecorators，会破坏 @callable”），非混淆或注入迹象 |
| ⑤作者/组织信誉 | cloudflare 官方 GitHub 组织，Cloudflare 为一线基础设施服务商 |
| ⑥License | Apache-2.0，明确 |
| ⑦最近维护 | 子技能路径最后提交 2026-04-15；仓库整体 2026-07-13 仍有提交，仓库层面维护活跃 |
7. 跟同类 Skills 相比的优势
DevOps 与基础设施类的其他官方云厂商技能、以及同仓库姊妹技能与本技能的定位差异：
| 名称 | 定位 | 与本技能的差异 |
|---|---|---|
| agents-sdk-cloudflare-skills（本推荐） | 在 Cloudflare Workers 上构建带状态 AI Agent 本身（RPC/调度/工作流/MCP） | 唯一聚焦“用 Agent 构建 Agent 产品”这一细分场景的官方技能，而非通用云平台操作指南 |
| cloudflare-cloudflare-skills（同仓库） | Cloudflare 全平台通用入口（Workers/Pages/存储/AI/网络/安全/IaC） | 定位更宽泛的平台综合导航技能，agents-sdk 是其 9 个姊妹技能之一，二者互补而非竞争 |
| gke-golden-path（Google 官方 google/skills） | GKE 生产级集群创建与配置审计，内置约 25 项安全/运维最佳实践默认值 | 聚焦 Kubernetes 集群运维治理，与“构建 Agent 应用本身”完全不同赛道，且更偏资深运维人员 |
| gke-security（Google 官方 google/skills） | GKE 集群安全加固审计 | 同为 Google GKE 系列的安全子集，定位窄于 golden-path，且同样是基础设施运维而非 Agent 构建 |
| vercel-cli-with-tokens（Vercel 官方 vercel-labs/agent-skills） | 使用 Vercel CLI 配合 Token 完成部署鉴权 | 单点部署鉴权工具型技能，功能范围远窄于 Agents SDK 的状态/RPC/调度全家桶 |
| aws-agents-for-devsecops（AWS 官方 aws/agent-toolkit-for-aws） | AWS DevSecOps 场景的 Agent 插件包 | 结构上是打包多个 skill/命令/示例的完整插件而非单一技能，且聚焦安全合规而非通用 Agent 构建 |
8. 用户评价
该技能目前在第三方平台尚无可验证的具名用户评价。第三方技能目录 agenticskills.io、claudemarketplaces.com、mcpmarket.com、claudepluginhub.com 等站点均收录了该技能，但仅为目录列表条目，未见实质评价文本。
9. 其他补充
cloudflare/skills是持续扩张的合集仓库，agents-sdk 与 cloudflare、durable-objects、wrangler、sandbox-sdk、web-perf、cloudflare-one 等同为其中的姊妹技能，本报告只覆盖 agents-sdk 这一项- 2026 年 6 月 InfoQ 报道了 Cloudflare 同期发布的 “Cloudflare One” Agent Skills 技能栈（Zero Trust 场景），侧面印证 Cloudflare 正持续投入官方 Agent Skills 生态建设
- 仓库当前约 17 个 open issues、11 个 open PR，反馈渠道活跃
10. 安装使用方式
# Claude Code（插件市场，推荐）
/plugin marketplace add cloudflare/skills
/plugin install cloudflare@cloudflare
# npx skills CLI
npx skills add https://github.com/cloudflare/skills
# 手动安装：clone 仓库后复制 skills/agents-sdk 目录到本地 Agent 技能目录
# Claude Code 对应目录：~/.claude/skills/安装后无需重启，Agent 在判断当前任务涉及“用 Cloudflare Workers 构建 Agent”时会自动加载生效。实际部署到 Cloudflare 账号（如绑定 Durable Objects、配置 Workers AI）还需用户自行完成一次 wrangler login 鉴权，技能本身不代为处理账号凭据。
11. 注意事项
- 该技能是
cloudflare/skills合集仓库中的一个子技能，其余姊妹技能（cloudflare 综合入口、durable-objects、wrangler 等）各自独立，覆盖更细分场景需额外安装 - OpenClaw、Hermes Agent 兼容性未见官方材料佐证，如需使用建议自行验证
- 子技能路径最后提交距今约 3 个月，虽仓库整体仍活跃维护，但具体到 agents-sdk 本身的更新频率略低于同仓库其他技能，建议关注后续版本变化
- 实际使用涉及 Cloudflare Workers/Durable Objects 计费，虽有免费额度，规模化使用后需自行评估成本