viewway PR Creator
何时使用
- 用户说 "创建 PR"、"提 PR"、"merge request"
- 完成功能开发准备提交
工作流
1. 分支安全检查
# 确认不在 main 分支
git branch --show-current
如果当前在 main，必须先创建新分支：
git checkout -b feat/描述性名称
禁止直接 push main。
2. 提交变更
# 检查未提交的变更
git status
# 暂存并提交
git add .
git commit -m "type(scope): description"
Commit 格式
遵循 Conventional Commits：
| Type | 用途 | 示例 |
|---|---|---|
feat |
新功能 | feat(collector): add DLMS task scheduler |
fix |
Bug 修复 | fix(meter): resolve serial number unique constraint |
docs |
文档 | docs(api): update meter endpoint docs |
refactor |
重构 | refactor(schemas): simplify response models |
test |
测试 | test(task): add task service unit tests |
chore |
杂项 | chore(deps): update sqlalchemy to 2.0.36 |
3. Preflight 检查
# 后端
cd backend && uv run ruff check . && uv run pytest
# 前端（如有前端变更）
cd frontend && pnpm run lint && pnpm run build
检查失败时，修复问题后再继续。不要跳过。
4. 推送分支
# 再次确认不是 main
git branch --show-current
# 推送
git push -u origin HEAD
5. 创建 PR
# 写描述到临时文件
cat > /tmp/pr_body.md << 'EOF'
## 变更说明
<简要描述本次 PR 做了什么>
## 变更类型
- [ ] 新功能 (feat)
- [ ] Bug 修复 (fix)
- [ ] 重构 (refactor)
- [ ] 文档 (docs)
- [ ] 测试 (test)
## 检查清单
- [ ] 代码已通过 lint 检查
- [ ] 测试已通过
- [ ] 数据库迁移已生成（如有模型变更）
- [ ] 无硬编码密钥/密码
## 相关 Issue
Fixes #
EOF
# 创建 PR
gh pr create --title "type(scope): 简要描述" --body-file /tmp/pr_body.md
# 清理
rm /tmp/pr_body.md
安全护栏
| 规则 | 说明 |
|---|---|
| 禁止 push main | 最高优先级，每次 push 前必须确认分支 |
| 禁止跳过 preflight | lint 和测试必须通过 |
| 禁止硬编码密钥 | 提交前检查 |
| 必须使用模板 | PR 描述必须包含检查清单 |
PR 标题规范
type(scope): 中文简要描述
示例：
feat(devices): 添加电表批量导入功能fix(collector): 修复任务超时重试逻辑refactor(auth): 重构 JWT token 刷新机制