Pull Request Workflows

This skill handles the complete PR lifecycle. Based on context and user intent, follow the appropriate workflow.

Context

• Current git status: !git status
• Current branch: !git branch --show-current
• PR state (if exists): !GH_PAGER= gh pr view --json number,title,state 2>/dev/null || echo "No PR for current branch"
• Arguments: $ARGUMENTS

Workflow Selection

Determine which workflow to use based on context:

Use Creating Workflow when:

• User asks to "create a PR", "open a PR", "push for review"
• On a feature branch with uncommitted or unpushed changes
• No PR exists for the current branch

→ See ./references/creating-workflow.md

Use Reviewing Workflow when:

• User asks to "review PR", "check code quality", "run review"
• PR exists and is open
• Want a fresh code review against the PR diff using targeted reviewers
• This workflow does NOT address existing review comments — it runs its own analysis

→ See ./references/reviewing-workflow.md

Use Addressing Workflow when:

• User asks to "address comments", "fix review feedback", "respond to reviewer"
• PR exists with unresolved review comments from human reviewers or bots
• User wants to respond to specific existing feedback without running a fresh review

→ See ./references/addressing-workflow.md

Use Merging Workflow when:

• User asks to "merge PR", "complete PR", "finalize changes"
• PR exists, is reviewed, and ready for merge
• Need to run final CI checks and merge

→ See ./references/merging-workflow.md

Quick Reference

Intent	Workflow	Key Actions
"Create PR"	Creating	Branch → Commit → Push → <path-to-skill>/scripts/create_pr_safe.py
"Review PR"	Reviewing	Gather context → Fetch diff → Scope & run reviewers → Present findings → Fix
"Address comments"	Addressing	Fetch comments → User selects → Fix → Reply → Push
"Merge PR"	Merging	CI checks → Confirm ready → gh pr merge → Checkout main