pull-request

Pull Request Command

Creates a new feature branch, commits changes, pushes to GitHub, and opens a pull request - all in one command. Perfect for contributing features or fixes.

Task

Automate the entire pull request workflow: create branch, stage changes, commit with descriptive message, push to GitHub, and open PR with proper description.

Process

1. Check Prerequisites

• Ensure git repository exists
• Check for uncommitted changes to include
• Verify GitHub CLI (gh) is available
• Get current branch as base branch
• If already on feature branch, ask: "Create PR from current branch?"

2. Create Feature Branch

# Generate branch name from PR title or use provided name
# Sanitize branch name: lowercase, replace spaces with hyphens, remove special chars
branch_name=$(echo "$branch_name" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9-]/-/g' | sed 's/--*/-/g')

# Check if branch already exists
if git show-ref --verify --quiet refs/heads/$branch_name; then
  echo "Branch $branch_name already exists, using alternative name"
  branch_name="${branch_name}-$(date +%s)"
fi

# Format: feature/short-description or fix/issue-name
git checkout -b $branch_name

3. Stage and Review Changes

• Show git status to user
• Show git diff --staged for review
• If no staged changes, stage all changes: git add -A
• Confirm changes with user before proceeding

4. Commit Changes

• Analyze changes to create meaningful commit message
• Use conventional commits format (feat:, fix:, docs:, etc.)
• Include detailed commit body if changes are complex

git commit -m "feat: add new feature

- Detail 1
- Detail 2

🤖 Generated with Claude Code"

5. Push to GitHub

# Push with upstream tracking
git push -u origin feature/[branch-name]

6. Create Pull Request

Use gh pr create with:

• Descriptive title
• Detailed body with:
  • Summary of changes
  • Testing checklist
  • Related issues (if any)
• Set base branch (usually main/master)