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

1. Fetch the PR diff using gh pr diff <PR>.
2. Fetch the PR title using gh pr view <PR> --json title --jq .title.
3. 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
4. Show the generated description to the user.
5. Ask the user if they want to apply it to the PR.
6. 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