Describe a Pull Request

Create or update the pull request for the current task with a concise description that helps a reviewer understand why the change exists and the shape of the implementation.

Workflow

1. Read the description template:

   Read({SKILLBASE}/references/pr_description_template.md)

2. Identify or create the pull request:

   • Check the current branch for a PR with gh pr view --json url,number,title,state,baseRefName,headRefName 2>/dev/null.
   • If no PR exists, inspect git status --short --branch and the commits on the current branch.
   • Commit task-related changes when needed, push the branch with an upstream, and create a PR for it. Follow the repository's git safety protocol.
   • Ask the user to select a PR only when the current branch has no relevant work and there is no safe current-branch PR to create.

3. Gather only the context needed to explain the change:

   • Read the ticket and any relevant task artifacts.
   • Read the complete PR diff and enough surrounding code to understand behavior and ownership.
   • Use gh pr view to collect PR metadata and changed files.