Update Pull Request
The PR body documents what will happen when merged, not the journey. Don't echo review feedback. Only mention changes if the ultimate result is user-facing.
Arguments
$0 (optional): the PR/MR to update, given as a URL, number, or branch name. The Workflow passes it to gh pr view/glab mr view. Default: with no argument, the tools resolve the PR/MR from the current branch.
Context
- Remote URL: !
git remote get-url origin
- PR Template: !
bun ${CLAUDE_PLUGIN_ROOT}/scripts/pr-template.ts
!bun ${CLAUDE_PLUGIN_ROOT}/scripts/git-context.ts
!bun ${CLAUDE_PLUGIN_ROOT}/scripts/sem-context.ts
!bun ${CLAUDE_PLUGIN_ROOT}/scripts/contributing.ts
Workflow
- Fetch PR context: Use
$0 (if provided) as a PR identifier (number or branch name). Fetch the current PR:
- GitHub:
gh pr view $0 --json title,body,updatedAt,commits
- GitLab:
glab mr view $0
- Fetch PR diff:
- GitHub:
gh pr diff $0
- GitLab:
glab mr diff $0
- Filter commits after
updatedAt to identify new work since the body was last written.
Writing
- Rewrite the PR body per
sections.md, the same rules the create skill follows. Load the writing skill for the full set of tropes to avoid. If a PR template is provided in context, preserve its structure. The Entities block in the context lists what changed at the function and class level, so use it to judge what the change did, but lead the body with intent and never reproduce the list.
- Write the updated body to a temp file (e.g.,
tmp/pr-body-<branch>.md) and apply:
- GitHub:
gh pr edit --body-file tmp/pr-body-<branch>.md
- GitLab:
glab mr update --description-file tmp/pr-body-<branch>.md
- A screenshot or recording the new body references by local path uploads with it:
--attach ./shot.png per file on gh pr edit (load github:attach), or project uploads per gitlab:api pasted in before the update. Assets already in the body keep their uploaded URLs.
GitLab Notes
For advanced GitLab features (username lookup), load gitlab:merge-request.