AgentSkillsCN

git-pr

根据分支变更自动生成拉取请求描述。适用于创建 PR，或为 PR 文档撰写做准备时使用。

SKILL.md
--- frontmatter
name: git-pr
description: Generate a pull request description from branch changes. Use when creating a PR or preparing PR documentation.
disable-model-invocation: true
allowed-tools: Bash(git:*), Bash(gh:*)

Generate PR Description

Create a comprehensive pull request description based on the branch diff.

Process

1. Gather Context

bash
# Get current branch name
git branch --show-current

# Find base branch (usually main or master)
git remote show origin | grep 'HEAD branch'

# Get all commits on this branch
git log main..HEAD --oneline

# Get the full diff
git diff main...HEAD --stat
git diff main...HEAD

2. Analyze Changes

Categorize the changes:

  • •Features: New functionality
  • •Fixes: Bug fixes
  • •Refactors: Code improvements without behavior change
  • •Docs: Documentation updates
  • •Tests: Test additions/changes
  • •Chores: Dependencies, configs, tooling

3. Generate PR Description

Use this format:

markdown
## Summary

[2-3 sentences describing what this PR does and why]

## Changes

- [Bullet point for each logical change]
- [Group related file changes together]
- [Focus on what changed, not how]

## Type of Change

- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that causes existing functionality to change)
- [ ] Refactor (no functional changes)
- [ ] Documentation update

## Testing

[How was this tested? What should reviewers verify?]

- [ ] Unit tests pass
- [ ] Integration tests pass
- [ ] Manual testing completed

## Screenshots (if applicable)

[Add screenshots for UI changes]

## Checklist

- [ ] My code follows the project's style guidelines
- [ ] I have performed a self-review
- [ ] I have added tests that prove my fix/feature works
- [ ] New and existing unit tests pass locally
- [ ] Any dependent changes have been merged

---

Generated with Claude Code

4. Determine Title

PR title format: type(scope): description

Examples:

  • •feat(auth): add OAuth2 login support
  • •fix(api): handle null response from payment service
  • •refactor(db): extract query builder into separate module

5. Output

Provide:

  1. •Suggested PR title
  2. •Full PR description in markdown
  3. •Suggested reviewers (if CODEOWNERS exists)
  4. •Labels to add (if .github/labels.yml exists)

6. Create PR (Optional)

If user confirms, create the PR:

bash
gh pr create --title "..." --body "..."

Guidelines

  • •Focus on why over what (the diff shows what)
  • •Link to related issues: Fixes #123 or Relates to #456
  • •Call out breaking changes prominently
  • •Mention any manual steps required post-merge
  • •Keep bullet points scannable (one line each)