cloudflare

Cloudflare 基础设施运维

管理 Cloudflare 服务：Workers、KV、R2、D1、Hyperdrive、Observability、Builds 和 Audit Logs。

MCP 为可选项。 此技能可通过 MCP（自动）、Wrangler CLI 或 Dashboard 使用。执行选项请参阅 BACKENDS.md。

权限级别

级别	用途	范围	风险控制
诊断	只读／查询／排障	Observability、Builds、Audit	默认入口，不执行写入
变更	创建／修改／删除资源	KV、R2、D1、Hyperdrive	需要确认和验证
超级管理员	最高权限	全部功能 + Container Sandbox	仅限隔离／测试环境

安全规则

读取操作

1. 先定义范围 — 账号／Worker／资源 ID
2. 未设置账号？ — 先列出账号，然后设置当前账号
3. 需要证据 — 结论必须有日志／屏幕截图／审计记录支持

写入操作（三步流程）

1. Plan: Read current state first (list/get)
2. Confirm: Output precise change (name/ID/impact), await user confirmation
3. Execute: create/delete/update
4. Verify: audit logs + observability confirm no new errors

禁止操作

• ❌ 未经确认执行创建／删除／更新操作
• ❌ 删除生产资源（除非用户明确说“删除生产环境中的 xxx”）
• ❌ 在非隔离环境中使用超级管理员权限
• ❌ 将容器沙箱用作持久化环境

操作类别

诊断级别（只读）

类别	可执行操作
Observability	查询 Worker 日志／指标，发现字段，探索取值
Builds	列出构建历史，获取构建详情，查看构建日志
Browser	获取页面 HTML，转换为 Markdown，截取屏幕截图
Audit	按时间范围拉取变更历史
Workers	列出 Worker，获取详情，查看源代码

变更级别（写入操作）

资源	操作
KV	列出、获取、创建 ⚠️、更新 ⚠️、删除 ⚠️
R2	列出、获取、创建 ⚠️、删除 ⚠️
D1	列出、获取、查询、创建 ⚠️、删除 ⚠️
Hyperdrive	列出、获取、创建 ⚠️、编辑 ⚠️、删除 ⚠️

⚠️ = 需要确认

超级管理员级别（Container Sandbox）

用于隔离任务的临时容器（生命周期约 10 分钟）：

• 初始化、执行命令、读取／写入／删除文件
• 适用于：运行测试、复现问题、解析数据
• 不适用于：持久化状态、生产工作负载

常见工作流

故障排查流程

1. Clarify symptoms → worker name / time range / error type
2. Query observability to pull logs/metrics
3. If build-related → get build logs
4. If page-related → take screenshot to reproduce
5. Trace changes → pull audit logs
6. Summarize: root cause + evidence + fix recommendations

资源管理流程

1. List accounts → set active account
2. List resources (KV / R2 / D1)
3. Plan changes → present to user
4. Execute after confirmation
5. Verify: audit logs + observability shows no errors

输出格式

• 语言：英文
• 结构：结论 → 关键数据／证据 → 工具调用摘要 → 后续步骤
• 写入操作：必须清楚列出操作和影响范围

示例：

✅ Investigation complete: worker `api-gateway` experienced 5xx spike between 18:00-18:30

Root cause: New code deployed threw TypeError when processing /v2/users
Evidence:
- Logs: 18:02 first occurrence of "Cannot read property 'id' of undefined"
- Audit: 18:00 user [email protected] deployed new version
- Metrics: error_rate jumped from 0.1% to 12%

Recommendation: Roll back to previous version, or fix /v2/users handler

基于文件的流水线

集成到多步骤工作流时：

runs/<workflow>/active/<run_id>/
├── proposal.md                # Symptoms/objectives
├── context.json               # Account/worker/resource/time_range
├── tasks.md                   # Checklist + approval gate
├── evidence/observability.md
├── evidence/audit.md
├── evidence/screenshots/
├── evidence/change-plan.md    # Write operations written here first
├── evidence/report.md         # Conclusion + evidence + next steps
└── logs/events.jsonl          # Optional tool call summary

错误处理

情况	操作
未设置账号	先运行 accounts_list → set_active_account
资源不存在	验证 ID／名称，列出可用资源
权限不足	说明所需权限，检查 API token 范围
Observability 查询范围过广	拆分为更小的时间范围

相关文件

• BACKENDS.md — 执行选项（MCP／CLI／Dashboard）
• SETUP.md — MCP 配置（可选）
• scenarios.md — 20 个真实场景示例