_pr-creator
📌 技能描述
自动化 PR 创建流程，包括智能版本检测、PR 描述生成、分支同步与推送。
适用场景：创建/更新 PR、版本变更、分支合并前
学习来源：SilentFeed PR 创建流程实践与常见失败案例
🎯 核心能力
| 能力 | 说明 |
|---|---|
| 智能版本检测 | BREAKING → major, feat → minor, fix → patch |
| 多语言模板 | 中文/英文 PR 描述模板 |
| 智能更新 | 检测已存在 PR 并更新，避免重复 |
| Dry-run 预览 | 执行前预览变更 |
| 多格式支持 | package.json, manifest.json, pyproject.toml, setup.py |
🚀 快速使用
直接告诉 AI："创建 PR" 或 "Create a PR"
AI 会自动完成：
- •分析提交类型 → 决定版本策略
- •生成 PR 标题和描述（基于模板）
- •同步分支 → 运行脚本 → 创建/更新 PR
✅ 执行流程
1. AI 分析提交（自动）
python
# 检测提交类型 commits = git log origin/master..HEAD has_breaking = "BREAKING" in commits or "!:" in commits has_feat = "feat:" in commits # 决定版本策略 bump = "major" if has_breaking else "minor" if has_feat else "patch"
2. 生成 PR 描述
使用 create_file 创建 .github/pr-description.tmp，参考模板：
- •中文：
.copilot/skills/_pr-creator/references/pull_request_template_zh.md - •英文：
.copilot/skills/_pr-creator/references/pull_request_template.md
3. 同步并运行脚本
bash
# 同步远端分支 git fetch origin && git rebase origin/<branch> # 运行脚本 PR_BRANCH="<branch>" \ PR_TITLE_AI="<title>" \ PR_LANG="zh-CN" \ VERSION_BUMP_AI="minor" \ CURRENT_VERSION="0.6.4" \ NEW_VERSION="0.7.0" \ VERSION_FILE="package.json" \ bash .copilot/skills/_pr-creator/scripts/create-pr.sh
必需变量：PR_BRANCH, PR_TITLE_AI, VERSION_BUMP_AI
版本策略：major | minor | patch | skip
❗ 常见问题
| 问题 | 原因 | 修复 |
|---|---|---|
| 脚本路径错误 | 使用了旧路径 | 使用 .copilot/skills/_pr-creator/scripts/create-pr.sh |
| 推送失败 (non-fast-forward) | 分支落后远端 | git fetch && git rebase origin/<branch> |
| 未提交变更警告 | 临时文件未清理 | rm -f .github/pr-description.tmp |
| 重复 version bump | 多次运行脚本 | 后续运行使用 VERSION_BUMP_AI=skip |
🧰 检查清单
- • 工作区干净，无未提交变更
- • 已同步远端分支（
git fetch && rebase） - • PR 描述文件已生成（
.github/pr-description.tmp） - • 版本策略正确（major/minor/patch/skip）
- • 脚本路径正确
📚 参考资料
版本检测规则（Conventional Commits）：
- •
BREAKING CHANGE或!:→ major - •
feat:→ minor - •
fix:,refactor:,docs:→ patch
脚本变量：
| 变量 | 示例 | 说明 |
|---|---|---|
PR_BRANCH | feat/my-feature | 当前分支名 |
PR_TITLE_AI | feat: 添加认证 | PR 标题 |
PR_LANG | zh-CN / en | 语言（决定模板） |
VERSION_BUMP_AI | minor / skip | 版本策略 |
CURRENT_VERSION | 0.6.4 | 当前版本 |
NEW_VERSION | 0.7.0 | 目标版本 |
VERSION_FILE | package.json | 版本文件路径 |
DRY_RUN | true / false | 预览模式 |
PR 模板路径：
- •
.copilot/skills/_pr-creator/references/pull_request_template_zh.md - •
.copilot/skills/_pr-creator/references/pull_request_template.md
💡 使用示例
创建功能 PR
python
# 1. 分析提交 → 决定 minor 版本
# 2. 生成描述
create_file(
filePath=".github/pr-description.tmp",
content="""## 概述
添加用户配置功能
## 变更内容
- 新增用户资料页面
- 新增设置页面
## 版本管理
- 当前版本: 0.6.4
- 最终决定: 0.7.0 (minor)
---
> 🤖 本 PR 由 _pr-creator 技能自动生成"""
)
# 3. 执行脚本
run_in_terminal(
command="bash .copilot/skills/_pr-creator/scripts/create-pr.sh",
env={
"PR_BRANCH": "feat/user-profile",
"PR_TITLE_AI": "feat: 添加用户配置",
"PR_LANG": "zh-CN",
"VERSION_BUMP_AI": "minor",
"CURRENT_VERSION": "0.6.4",
"NEW_VERSION": "0.7.0",
"VERSION_FILE": "package.json"
}
)
Dry-run 预览
bash
DRY_RUN=true \ PR_BRANCH="feat/test" \ PR_TITLE_AI="feat: test" \ PR_LANG="zh-CN" \ VERSION_BUMP_AI="minor" \ CURRENT_VERSION="0.7.0" \ NEW_VERSION="0.8.0" \ VERSION_FILE="package.json" \ bash .copilot/skills/_pr-creator/scripts/create-pr.sh
🔗 相关技能
- •_git-commit：提交前使用，确保提交规范
- •_code-health-check：PR 前使用，确保代码质量
- •_evolution-core：发现问题时沉淀改进
🎖️ 技能签名
PR 描述末尾包含：
markdown
--- **PR Tool**: _pr-creator Skill