create-pr

# Create Pull Request Use this skill when the user asks to create or update a PR for the current branch. ## Inputs - Optional `--draft` - Optional `--base <branch>` (default: `main`) ## Preconditions 1. Verify the current branch is not `main` or `master`. 1. Check for uncommitted changes with `git status --short`. 1. Ensure `gh` is available. 1. If there are uncommitted changes, stop and ask the user whether to commit or stash them first. ## Workflow ### Step 1: Check for an existing PR - Run `gh pr view --json number,title,url,state,isDraft`. - If a PR already exists, tell the user before rewriting history or force-pushing. ### Step 2: Fetch and rebase ```bash git fetch origin <base> git rebase origin/<base> ``` - If rebase conflicts occur, abort the rebase and stop. - Tell the user which files conflicted and ask them to resolve manually. ### Step 3: Squash into one commit ```bash git reset --soft origin/<base> ``` - Load the `commit-conventions` skill before generating the commit message. - Infer `type` and `scope` from the staged diff. - Keep the commit subject imperative and under about 72 characters. ### Step 4: Generate PR title and body - Use the squashed commit message style for the PR title. - Follow the repository PR template at `.github/PULL_REQUEST_TEMPLATE.md`. - Summarize user-facing changes, risk areas, test commands run, and skipped suites with reasons. ### Step 5: Push and create or update the PR - Push the branch. - If history was rewritten, confirm before force-pushing. - Create or update the PR with `gh pr create` or `gh pr edit`. - Respect `--draft` when requested. ## Guardrails - Never create a PR from `main` or `master`. - Never silently force-push over an existing PR branch. - Never bypass `commit-conventions` for the squashed commit. - If `gh` authentication or remote permissions fail, stop and report the exact blocker. ## Output Report: - Base branch used - Final commit message - PR title - PR URL, if creation or update succeeded - Any steps that were skipped or require user follow-up