用途:在 Cloudflare 文档站点的 src/content/changelog/ 目录下创建、编辑或审阅产品更新日志条目。写作前需准备三项信息:产品名称(如 Workers、KV、Hyperdrive、Containers、R2)、变更描述,以及足以说明“为什么”和使用场景的上下文;缺失时应先询问,不可直接动笔。
主要能力:根据产品名在 src/content/changelog/{product}/ 下定位正确文件夹(需核对已有文件夹,不可猜测);按 src/content/changelog/{product}/{YYYY-MM-DD}-{useful-short-name}.mdx 格式创建文件;生成含 title、description、products、date 的 frontmatter;按 .agents/references/style-guide.md 及 changelog 专属规则撰写正文,面向技术开发者与云用户。
代码示例:涉及 API、SDK 或配置变更时应附简短示例。frontmatter 后导入组件:import { TypeScriptExample, WranglerConfig } from "~/components";。Workers JS/TS 用 TypeScriptExample;Wrangler 配置用 WranglerConfig(TOML 输入,compatibility_date 用 $today);其他语言用带正确语言标识的普通代码块;非 Workers 配置(JSON、YAML 等)用普通代码块。
文档链接:结尾链接相关文档,使用相对路径(如 /workers/configuration/placement/),链接文字需描述目标,避免“点击这里”。可检查未提交/已暂存的 .md/.mdx 文件作为关联文档。
参考与编辑:写作前阅读目标产品文件夹中 2-3 条已有条目以匹配风格;若不足 2 条,参考 workers、kv、hyperdrive、containers 文件夹。编辑已有条目时保留原结构与语气,仅做所请求的修改。
审阅:按 frontmatter 字段、文件路径规范、写作风格、代码示例质量、文档链接逐项校验,并按严重程度标记:Error(缺少必填 frontmatter、产品文件夹错误、链接失效)、Warning(风格违规、API 变更缺代码示例、描述含糊)、Nit(措辞改进)。输出为创建或更新后的 changelog 文件,并展示完整文件路径与内容。