用途:在 Fluid Framework 仓库中创建拉取请求时使用,按该仓库约定撰写 PR 标题与正文,并在用户确认后推送分支、创建 PR。
主要能力与流程:先确认当前不在 main 或发布分支,否则停止并提示用户先创建或切换到功能分支;确认 origin 远程不指向 microsoft/FluidFramework,否则停止并提示应推送到自己的 fork(前缀为 test/ 的分支用于 Azure Pipelines 测试时为例外)。随后必须通过 Skill 工具加载 fluid-pr-guide 技能,依据其中的标题约定、正文模板与章节指引撰写标题和正文,不得凭记忆跳过。将拟定的标题与正文以文本形式打印,再用 AskUserQuestion 工具让用户选择:Create PR、Create draft PR、Edit、Cancel。选择 Edit 则修改后重新展示;选择创建则推送并创建。
推送与创建:推送前运行 git remote get-url origin 校验远程地址。首次推送使用 git push -u origin <feature-branch>;创建 PR 使用 gh pr create --title "<title>" --body "$(cat <<'EOF' ... EOF)",草稿 PR 额外加 --draft。创建后输出 PR URL。
更新已有 PR:无权限通过 API 编辑上游 microsoft/FluidFramework 仓库的 PR,需将新内容写入临时文件(如 $TMPDIR/pr-body.md)并提示用户手动复制粘贴到 GitHub。
限制:不能从受保护分支创建 PR;不允许直接向主仓库推送分支(test/ 前缀的流水线变更除外);无法直接编辑上游 PR。具体标题约定与正文模板内容需加载 fluid-pr-guide 获取,资料未提供其细节。