| name | generate-pr-description |
| description | Generate a structured PR description from the diff. Fetches the diff, analyzes changes, and optionally applies the description. |
| user-invocable | true |
| arguments | <PR number or URL> |
Generate PR Description
Generate a structured pull request description by analyzing the diff.
Steps
- Fetch the PR diff using
gh pr diff <PR>.
- Fetch the PR title using
gh pr view <PR> --json title --jq .title.
- Analyze the diff and generate a description with these sections:
- ## Summary — 1-2 sentences on purpose and motivation
- ## Changes — bulleted list of logical changes
- ## Testing — suggested verification steps
- Show the generated description to the user.
- Ask the user if they want to apply it to the PR.
- If confirmed, apply via
gh pr edit <PR> --body "<description>".
Guidelines
- Keep descriptions under 500 words
- Use present tense ("Add", "Fix", "Update")
- Focus on intent and impact, not line-by-line details
- Do not repeat the PR title — provide additional context