用途:为 cloudflare-docs 的改动准备、创建和更新拉取请求(PR)或合并请求(MR),统一标题、分支与正文规范。
主要能力:从当前仓库的 remote 与配置识别托管方和目标仓库,不硬编码;使用对应集成或已认证 CLI 读写请求;支持编辑已有请求的标题与描述,并在推送新提交后主动检查标题与描述是否仍准确。
使用方式:先确定目标分支 <base>(新请求默认 production,而非 main),运行 git log --oneline <base>..HEAD、git diff <base>...HEAD --stat、git status 收集上下文;改动超过约 20 个文件时不跑完整 diff。标题对内容改动用 [Product] 短描述,跨产品用 [Product1, Product2],非内容改动用 chore:/fix:/feat: 前缀,产品名从文件路径推断。正文以仓库中的模板为基准,填写 Summary,按需保留截图与文档检查清单项。正文较长时写入临时文件并用文件输入选项,避免破坏 Markdown 格式。创建前检查是否已有同 head 分支与目标的开放请求,避免重复;支持草稿时创建为草稿。
适用场景:cloudflare-docs 的文档新增、更新、修复、重构与 changelog 条目等改动。
限制:无托管方集成或已认证 CLI 时应停止并说明阻塞,不得声称已创建或更新;公开仓库中不得包含私有信息、密钥或内部资源链接;编辑已有请求时须保留作者原有结构并做最小改动。具体命令语法不确定时先查工具帮助。