mcpField
W
workers-development

workers-development

github.com/cloudflare其他3.3k758 次安装1 天前更新
代码仓库

关于 workers-development

面向 Cloudflare Workers 项目的开发与调试技能，遵循项目现有工具和配置。支持检查本地绑定数据与调用轨迹，并可在连接 Cloudflare MCP 时查询已部署 Worker 的可观测性数据。

主要功能

  1. 01沿用项目现有开发命令
  2. 02检查本地绑定数据
  3. 03捕获本地请求轨迹和日志
  4. 04查询已部署服务的可观测性数据

适用场景

  1. 01为本地 KV、R2 或 D1 填充数据
  2. 02检查本地请求的调用轨迹
  3. 03查找已部署 Worker 的日志或指标

MCP 相关

连接 Cloudflare MCP 服务后，可通过其 search 和 execute 操作查找并调用 Workers Observability API 操作。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cloudflare/skills --skill workers-development

安装后在 Claude Code 中输入/workers-development确认已加载。

附带文件references/skill-feedback.md

详细介绍

Workers 开发与调试

使用项目现有的工具、脚本和配置。已安装的帮助信息、Local Explorer API 架构和当前文档介绍了受支持的操作；请先阅读，不要猜测端点或标志。

需求工具与发现方式
本地运行使用项目现有的开发命令：在 cf 项目中运行 cf dev，否则运行 Wrangler 或 Cloudflare Vite 开发脚本。请参阅本地开发。
检查或填充本地绑定数据Local Explorer 是一个用于本地 KV、R2、D1、SQLite 支持的 Durable Objects 和 Workflows 的界面与 API，也可以触发 Cron 处理程序。在开发服务器的源站上打开 /cdn-cgi/local/explorer。
调试本地请求Local Explorer 会捕获每次本地调用的跟踪记录和日志，包括绑定操作，无需修改代码。添加日志前先检查跟踪记录。
调试已部署的 Worker使用 Workers 可观测性选择日志、跟踪记录或指标；如果已安装 cloudflare 技能，也可以使用其中的可观测性参考。如果已连接 Cloudflare MCP 服务（随此插件提供），请使用 search 查找 Workers Observability API 操作，然后使用 execute 调用这些操作，并限定目标账户、Worker 和时间范围。

使用 Local Explorer API

当开发服务器检测到 AI Agent 时（包括在 cf dev 下运行），会打印一条提示，其中包含 API URL 和相关端点。从开发服务器的源站请求 /cdn-cgi/local/explorer/api 上的 OpenAPI 规范，然后仅提取任务所需的操作。如果没有出现提示，请直接请求该 URL。如果 API 或某项操作缺失，请对照 Local Explorer 文档中的要求，检查已安装的 Wrangler 或 Vite 插件版本。

默认情况下，绑定会在本地模拟，但设为 remote: true 的绑定会在 Worker 本地运行时访问实际部署的资源。跟踪记录也会捕获这些远程调用。填充或写入数据前，请确认哪些绑定是远程绑定。

技能反馈

如果用户反馈此技能提供了错误或过时的指导，或者缺少信息，请阅读 references/skill-feedback.md。

评论

支持 Markdown