用途:这是对 Cloudflare Docs 仓库做任何改动时加载的单一技能,负责把当前任务路由到正确的参考文档,而非直接提供细节。不要凭猜测套用约定,参考文档才是本仓库内容撰写、结构与校验的权威来源;规范参考优先于冲突的本地写法,尤其是产品分区名称、目录与排序。
主要能力:按任务索引指向不同参考,例如撰写或编辑文档页读 references/writing-docs.md,决定 pcx_content_type 与页面形态读 references/content-types.md,选择数据展示组件读 references/choosing-components.md,决定页面归属、重定向与复用读 references/information-architecture.md,写作与格式规则查 .agents/references/style-guide.md 与 procedures.md,组件属性与示例查 .agents/references/components.md,更新日志读 references/changelog.md,评审文档读 references/reviewing-docs.md。
使用方式:先收集上下文,资料不足或含糊时先询问用户,需要来源依据、产品与功能区域、受众与意图、可用性(套餐与生命周期状态)、改动范围。分支须基于最新 production(git fetch origin 后从 origin/production 拉出),默认分支是 production 而非 main。不要自动提交或推送,改完文件后询问用户是否提交。
校验:内容改动后运行 pnpm run check(类型检查,校验 frontmatter 与 Astro 类型)、pnpm run build(完整构建,仅限本地,CI 会超时)、pnpm run format(自动修复 Prettier 格式)。CI 环境(CI=true)跳过 build,只运行 check、lint 与 format:core:check。若修改 public/__redirects,还需运行 pnpm exec tsm bin/validate-redirects.ts。改动过的文件务必运行 format,否则 CI 会失败。
限制:这是公开开源仓库,禁止写入私有 Cloudflare 信息、密钥、凭据、内部 URL 或环境变量值;有任何疑虑都应停下询问用户。