用途:在 Gitee 仓库中按团队约定自动创建并提交 Pull Request,适合需要规范化 PR 流程的团队。
主要能力:
- 使用 scripts/create_gitee_pr.py 执行规则优先的 PR 工作流,创建前先应用 gitee-pr-rules.md 中的团队规则。
- 解析 head 与 base 分支;强制分支命名格式为 member/verb-description。
- 确保工作区干净,或在启用 --auto-commit 时自动提交。
- 校验 remote/base..head 范围内所有提交主题的前缀:feat:、fix:、docs:、refactor:、style:、test:、chore:。
- 当多个核心文件被改动时发出非阻塞警告。
- 强制 PR 标题和正文包含中文。
- 强制 PR 正文按模板分区及顺序:## 改动了什么?、## 为什么改动?、## 测试结果?、## 注意事项。
- 除非使用 --no-push,否则推送分支;通过 Gitee API 创建 PR 并打印 PR URL。
必要输入:设置 Gitee token(环境变量 GITEE_TOKEN 或 --token);确保远程为 Gitee 仓库或提供 --repo owner/repo;在 Git 仓库内运行。
使用方式: 设置环境变量后运行脚本,例如: export GITEE_TOKEN="<token>" python3 scripts/create_gitee_pr.py --base main --title "修复:优化过滤逻辑" 支持 --auto-commit 自动提交本地改动,--dry-run --no-push 仅校验并预览 PR 正文,或通过 --body 传入符合模板的自定义正文。未提供 --body 时脚本生成默认模板。
合并后清理:使用 git branch -d <branch-name> 和 git push origin --delete <branch-name> 删除分支。
限制:需有效 Gitee token 与 Git 仓库环境;具体规则细节、错误处理与平台兼容性资料未提供。