Cloudflare Agents SDK v0.14.0：先给 Agent Skills 做目录治理

这篇解决什么

Agent Skills 能按任务激活说明、资源和脚本，避免把大型能力库塞进每次提示。但技能目录没有治理时，重复技能、过期脚本和权限膨胀会让 Agent 行为不可预测。

适合谁

适合在 Cloudflare Workers 上构建多技能 Agent、客服机器人、研发助手和自动化平台的开发者。

操作步骤

1. 为每个 Skill 写清触发场景、输入、输出和禁止动作
2. 把本地 skills 目录、R2 skills 和 manifest 来源分开管理
3. 为可执行脚本增加审批、超时和日志
4. 定期扫描重复或失败的 Skill source
5. 用 20 个真实任务验证激活准确率
6. 把稳定技能加入版本化目录

可复制模板

Skill：
触发词：
输入：
输出：
脚本权限：
日志位置：
版本：

验收清单

• 每个 Skill 有边界
• 来源分层管理
• 脚本可审计
• 重复技能已清理
• 激活准确率已验证

常见错误

• 只收藏产品更新，没有改成自己的任务卡、权限表和验收证据。
• 直接在生产账号、生产仓库或公开页面试新功能，没有先跑低风险样本。
• 只看工具能力，不记录成本、失败率、人工接管次数和恢复动作。
• 把外部链接当正文主体，读者离开页面后才知道怎么做。

30 分钟小样本

前 5 分钟写清输入、目标和风险边界；中间 15 分钟按步骤跑一个低风险样本；最后 10 分钟记录输出、失败点、人工修改量和下一次复用条件。样本不通过时，只修失败点，不扩大范围。

下一步怎么用

第一次执行时把它当成个人操作卡；第二次复用时沉淀为团队模板；第三次仍然稳定后，再升级为固定 SOP、Skill 或工具导航页。涉及账号、发布、删除、付费、生产代码和客户数据的动作，必须保留人工确认点。

资料依据

• Cloudflare Changelog / Agents SDK v0.14.0 / 2026-06-02

标签