用途:更新 GitHub Pull Request 的描述正文(body),当用户要求更新、编辑或修改 PR 描述时使用。
主要能力与用法:
- 获取当前分支对应的 PR 编号:gh pr list --head "$(git branch --show-current)" --json number --jq '.[0].number'
- 查看现有 PR 正文:gh pr view <pr-number> --json body -q '.body'
- 通过 REST API 更新正文:gh api -X PATCH /repos/{owner}/{repo}/pulls/<pr-number> -f body="New PR body content here."
- 追加内容时先读取现有正文,再拼接后写回。
限制与注意事项:资料明确警告不要使用 gh pr edit --body,因为它会因 Projects (classic) 弃用而报 GraphQL 错误,应始终使用上述 REST API 方式。
适用场景:需要修改 PR 描述、补充测试计划或追加说明时。具体安装方式、收费与平台支持等信息暂未提供。