/pr - Pull Request Creation Skill

Create Pull Requests that pass CI before creation and target the correct branch.

Language Requirement

IMPORTANT: All Pull Requests MUST be written in English.

• PR title: English
• PR body: English
• Commit messages: English

Pre-flight Checks (MANDATORY)

Before creating a PR, ALL of the following checks MUST pass:

1. Format Check

bash
1cargo fmt --all -- --check

If this fails, run cargo fmt --all to fix and commit the changes.

2. Clippy Check

bash
1cargo clippy --all-targets --all-features -- -D warnings

CRITICAL: Zero warnings required. Fix all issues before proceeding.

3. Test Suite

bash
1cargo test --all

All tests must pass.

Steps

Step 1: Run Pre-flight Checks

Execute all three checks above. If any fail:

1. Fix the issues
2. Commit the fixes using /commit skill
3. Re-run the checks until all pass

Step 2: Verify Branch Status

bash
1# Check current branch
2git branch --show-current
3
4# Check if up to date with remote
5git status

Verify:

• Not on main branch (direct commits to main are forbidden)
• Branch follows naming convention:
  • feature/<issue-number>-<description> for features
  • bugfix/<issue-number>-<description> for bug fixes
  • hotfix/<issue-number>-<description> for hotfixes
  • docs/<issue-number>-<description> for documentation
  • refactor/<issue-number>-<description> for refactoring

Step 3: Determine Base Branch

CRITICAL: This project uses develop as the integration branch.

Branch Creation Rule: Always create new branches from origin/develop:

bash
1git fetch origin
2git checkout -b feature/<issue>-<desc> origin/develop

Step 4: Review Changes

bash
1# See all commits that will be in the PR
2git log origin/develop..HEAD --oneline
3
4# See the diff
5git diff origin/develop...HEAD

Step 5: Push to Remote

bash
1git push -u origin $(git branch --show-current)

Step 6: Create Pull Request

Use the following template:

bash
1gh pr create --base develop --title "TITLE" --body "$(cat <<'EOF'
2## Summary
3[1-3 bullet points summarizing the changes]
4
5## Related Issue
6Closes #XX
7
8## Changes Made
9- [Change 1]
10- [Change 2]
11- [Change 3]
12
13## Test Plan
14- [ ] `cargo test --all` passes
15- [ ] `cargo clippy --all-targets --all-features -- -D warnings` passes
16- [ ] Manual testing performed (if applicable)
17
18## Screenshots (if applicable)
19[Add screenshots for UI changes]
20
21---
22Generated with [Claude Code](https://claude.com/claude-code)
23EOF
24)"

Step 7: Verify PR Creation

After creation:

1. Output the PR URL
2. Verify CI is running: gh pr checks
3. Report status to user

Error Handling

Pre-flight Check Failures

If any pre-flight check fails:

1. Format failure: Run cargo fmt --all, commit, retry
2. Clippy failure: Fix warnings, commit, retry
3. Test failure: Fix tests, commit, retry

NEVER create a PR if pre-flight checks fail.

Push Failures

If push fails:

1. Check if branch exists on remote
2. Check for conflicting changes
3. Pull and resolve conflicts if needed

PR Creation Failures

If gh pr create fails:

1. Check authentication: gh auth status
2. Check if PR already exists: gh pr list
3. Report error details to user

Example Usage

User: "PRを作成して"

Claude executes /pr skill:

1. Runs cargo fmt --all -- --check (passes)
2. Runs cargo clippy --all-targets --all-features -- -D warnings (passes)
3. Runs cargo test --all (passes)
4. Verifies branch is feature/84-agent-skills
5. Determines base branch is develop
6. Pushes to remote
7. Creates PR with English title and body (base: develop)
8. Reports PR URL to user