AgentSkillsCN

pr

使用 GitHub CLI 为当前分支创建拉取请求。在完成更改并准备发起 PR 时,可使用此技能。

SKILL.md
--- frontmatter
name: pr
description: Create a pull request for the current branch using GitHub CLI. Use after committing changes when ready to open a PR.
allowed-tools: Bash

Create Pull Request

Create a pull request for the current branch against main using the GitHub CLI.

Instructions

  1. Run git status to check for uncommitted changes (warn if any exist)
  2. Check if the branch has an upstream and is pushed
  3. Run git log main..HEAD --oneline to see all commits in this branch
  4. Run git diff main...HEAD --stat to understand the full scope of changes
  5. Create a PR with gh pr create

PR Format

Use a HEREDOC for the body to ensure proper formatting:

bash
gh pr create --title "<concise title>" --body "$(cat <<'EOF'
## Summary
<1-3 bullet points describing what this PR does>

## Test plan
- [ ] <how to verify this works>
EOF
)"

Title Guidelines

  • Keep under 72 characters
  • Use imperative mood ("Add feature" not "Added feature")
  • Be specific about what changed

Body Guidelines

  • Summary: 1-3 bullet points explaining what and why
  • Test plan: Checklist of verification steps

Pre-flight Checks

Before creating the PR:

  1. Ensure all changes are committed
  2. Ensure branch is pushed to remote
  3. If not pushed, run git push -u origin HEAD first

Example

bash
gh pr create --title "Fix cron machine image updates in CI/CD" --body "$(cat <<'EOF'
## Summary
- Fix CI/CD to explicitly pass --image when updating cron machines
- Cron machines created via `flyctl machine run` don't auto-update with app releases
- Fetches image from deployed app machines and passes it to machine update

## Test plan
- [ ] Deploy to staging and verify cron machine gets updated
- [ ] Check cron logs after next scheduled run
EOF
)"

After Creation

Return the PR URL so the user can review it.