QCC Plus Git 工作流
分支策略（强制）
强制规则: 所有开发工作必须在 test 分支进行，编写代码前必须确认当前分支。
| 分支 | 用途 | 说明 |
|---|---|---|
test | 日常开发 | ✅ 在这里开发，推送后自动部署到测试环境（端口 8001） |
main | 正式发布 | 合并测试通过的代码，用于打 tag 发布版本 |
prod | 生产部署 | 部署到生产服务器（端口 8000） |
编写代码前检查
bash1# 确认在 test 分支 2git branch --show-current 3 4# 如不在 test 分支 5git checkout test
工作流程
bash1# 1. 开发 2git checkout test 3# 编写代码 4git push origin test 5 6# 2. 发布 7git checkout main 8git merge test 9git tag vX.Y.Z 10git push origin vX.Y.Z 11 12# 3. 部署 13git checkout prod 14git merge main 15git push origin prod
Commit 格式
使用 Conventional Commits 格式：type: description
| 类型 | 说明 | 版本影响 |
|---|---|---|
feat | 新功能 | minor 升级 |
fix | Bug 修复 | patch 升级 |
feat! / fix! | 重大变更 | major 升级 |
docs | 文档更新 | 不触发 |
refactor | 代码重构 | 不触发 |
test | 测试相关 | 不触发 |
chore | 构建/工具 | 不包含在 CHANGELOG |
示例
feat: 添加健康检查 API 端点
fix: 修复节点切换延迟问题
docs: 更新 CLAUDE.md 文档结构
feat!: 重构 API 接口，移除 v1 兼容性
提交规范
Git 安全协议
- 永不更新 git config
- 永不运行破坏性命令（如 push --force, hard reset）除非用户明确请求
- 永不跳过 hooks（--no-verify, --no-gpg-sign）除非用户明确请求
- 永不强制推送到 main/master
- 避免
git commit --amend，仅在用户明确请求或添加 pre-commit hook 的编辑时使用 - 修改前总是检查作者：
git log -1 --format='%an %ae' - 永不提交更改除非用户明确要求
提交消息格式
使用 HEREDOC 确保格式正确：
bash1git commit -m "$(cat <<'EOF' 2Commit message here. 3 4🤖 Generated with [Claude Code](https://claude.com/claude-code) 5 6Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> 7EOF 8)"
质量保证
测试要求
- 核心业务逻辑必须有单元测试
- 使用真实数据测试，避免过度 mock
- 测试边界条件和错误场景
- 使用
go test -race检测竞态条件
代码审查
- 所有合并到 main 的代码必须经过审查
- 检查错误处理是否完善
- 检查是否有资源泄漏（goroutine、文件句柄）
- 检查并发安全性
