AgentSkillsCN

github-pr

使用gh CLI审查、创建及管理GitHub PR。查看差异、检查、评论，并以规范格式创建PR。

SKILL.md
--- frontmatter
name: github-pr
description: Review, create, and manage GitHub PRs using the gh CLI. View diffs, checks, comments, and create PRs with proper formatting.
triggers:
  - /github-pr
  - When reviewing pull requests
  - When creating pull requests
  - When checking PR status or CI checks
allowed-tools:
  - Bash
  - Read
  - Grep
  - Glob
  - Edit
  - Write

GitHub PR Management

Use the gh CLI for all GitHub PR operations. This avoids MCP overhead while providing full PR workflow support.

Common Workflows

Review a PR

bash
# View PR details
gh pr view <number>

# View PR diff
gh pr diff <number>

# View PR checks/CI status
gh pr checks <number>

# View PR review comments
gh pr view <number> --comments

# Checkout PR locally for testing
gh pr checkout <number>

Create a PR

bash
# Create with title and body
gh pr create --title "Title" --body "$(cat <<'EOF'
## Summary
- Change description

## Test plan
- [ ] Test steps

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"

# Create as draft
gh pr create --draft --title "WIP: Title" --body "Description"

Manage PRs

bash
# List open PRs
gh pr list

# Merge a PR
gh pr merge <number> --squash

# Close a PR
gh pr close <number>

# Add reviewers
gh pr edit <number> --add-reviewer username

# View PR as JSON for programmatic access
gh pr view <number> --json title,body,state,reviews,checks

Check CI Status

bash
# View all checks for current branch
gh pr checks

# View specific run details
gh run view <run-id>

# View run logs
gh run view <run-id> --log-failed

Best Practices

  • •Always use --json flag when you need structured data for analysis
  • •Use gh pr diff to review changes before approving
  • •Check gh pr checks before merging to ensure CI passes
  • •When creating PRs, always include a test plan section