PR Skill

Structured PR workflow: verify branch → ensure issue exists → push → create PR.

Announce at start: "I'm using PR skill to create your pull request."

Workflow

Step 0: Branch & Change Verification

git branch --show-current
git log main..HEAD --oneline
git diff main...HEAD --stat

Rules:

• If on main or master: STOP — create a new branch first (see commit skill Step 0)
• If no commits ahead of main: STOP — nothing to submit
• If branch has uncommitted changes: ask user whether to commit first

Step 1: Analyze Changes

Review ALL commits between main and HEAD (not just the latest):

git log main..HEAD --oneline
git diff main...HEAD

Summarize:

• What the PR accomplishes (feature, fix, refactor, etc.)
• Which modules/areas are affected
• Any breaking changes or migration notes

Step 2: Issue Association

Check if the user mentioned an issue during the conversation (e.g., "fixes #123", "关联 issue #45", or a GitHub issue URL).

Case A: Issue was mentioned

• Note the issue number for PR body (e.g., Closes #123)

Case B: No issue mentioned

• Create a new issue using gh issue create:

gh issue create --title "<concise title>" --body "$(cat <<'EOF'
## Description

<Brief description of what this change addresses>

## Context

<Why this change is needed>
EOF
)"

• Use the new issue number for PR body
• Title format: same convention as commit messages but in sentence case
• Label: add appropriate labels if available (enhancement, bug, documentation, etc.)

Step 3: Push Branch

git push -u origin <branch-name>

If push fails due to remote rejection, inform user and do NOT force-push.

Step 4: Create Pull Request

gh pr create --title "<pr-title>" --body "$(cat <<'EOF'
## Summary

<1-3 bullet points describing the changes>

## Changes

<List of key changes, grouped by area>

## Related Issue

Closes #<issue-number>

## Test Plan

- [ ] <test steps or verification items>
EOF
)"

PR Title rules:

• Under 70 characters
• Format: <type>(<scope>): <description> (same as commit convention)
• If single commit, reuse commit message as title
• If multiple commits, write a summary title

PR Body rules:

• Closes #<number> to auto-close the linked issue on merge
• Include test plan with actionable checklist
• If there are breaking changes, add a ## Breaking Changes section

Step 5: Post-PR

After creating the PR:

1. Output the PR URL to user
2. If the PR includes i18n changes, remind to verify all locales
3. If the PR includes new files in feature areas, remind about coverage config

Issue Creation Guidelines

When creating issues automatically:

Change Type	Issue Title Example	Labels
New feature	feat(webui): add file upload support	enhancement
Bug fix	fix(cron): timezone offset causes missed jobs	bug
Refactor	refactor(settings): decompose SkillsHubSettings	refactor
Docs	docs: add architecture conventions	documentation

Mandatory Rules

No AI Signature

NEVER add any AI-related signatures. This includes:

• Generated with <AI tool> in PR descriptions
• Co-Authored-By: <any AI tool> in commits
• Any AI-generated footer, byline, or emoji attribution

Always Link Issues

Every PR must reference an issue. No exceptions — create one if none exists.

No Force Push

NEVER force-push without explicit user approval.

Quick Reference

0. Verify branch (not main) and commits exist
1. Analyze all changes between main..HEAD
2. Find or create issue
3. git push -u origin <branch>
4. gh pr create --title "..." --body "..." with Closes #<issue>
5. Output PR URL