SuperAPI AI 工具集

repos-pull-request-write

编程与开发

查看项目

更新于 10-15 21:11

技能介绍

用途:站在作者角度,通过 Azure DevOps REST API 从当前 git 分支建立 PR,并修改自己建立的 PR;不提供手动完成或合并 PR,审查留言改用 repos-pull-request-review。

必要用法:命令一律用 curl 直呼 API,每个命令自带验证参数。先设定环境变量 AZURE_DEVOPS_ORG(如 contoso)与 AZURE_DEVOPS_PAT;PAT 以 Basic 送出:-u ":$AZURE_DEVOPS_PAT",只设 AZURE_DEVOPS_EXT_PAT 时改用后者,Entra ID 令牌则用 -H "Authorization: Bearer $AZURE_DEVOPS_TOKEN"。令牌只从环境变量读取,不要贴进对话或写入文件。PAT 需 Code(Read & write) 等权限;建立时用 git remote get-url origin 与 git rev-parse --abbrev-ref HEAD 判断仓库与分支,detached HEAD 时停止并请用户切换分支。

主要能力:建立 PR(确认分支已推送、决定目标分支、检查是否已有进行中 PR、依 commit 与 PR 模板拟标题描述、链接工作项目、查身份 ID 指定审查者或建立 draft、可加标签),修改 PR(发布或转回 draft、改标题描述、变更目标分支、取消 auto-complete、放弃或重新启用),以及设定 auto-complete(需先确认合并策略与是否删除来源分支)。

限制:不提供 status completed 手动完成与 bypassPolicy;draft 不会自动完成;移除审查者须到网页操作;描述上限 4000 字元。HTTP 401/403/203 或登录页代表令牌无效,404 表组织、项目、仓库或 PR ID 有误,409(TF401179)代表同来源目标已有进行中 PR,应改为修改它。写入失败不自动重试。报告结果时,PR 链接为 {repository.webUrl}/pullrequest/{pullRequestId}。