| name | qcc-git |
| description | Use for Git workflow, branch strategy, and commit conventions in qcc_plus project |
QCC Plus Git 工作流
分支策略（强制）
强制规则: 所有开发工作必须在 test 分支进行，编写代码前必须确认当前分支。
| 分支 | 用途 | 说明 |
|---|---|---|
test |
日常开发 | ✅ 在这里开发，推送后自动部署到测试环境（端口 8001） |
main |
正式发布 | 合并测试通过的代码，用于打 tag 发布版本 |
prod |
生产部署 | 部署到生产服务器（端口 8000） |
编写代码前检查
# 确认在 test 分支
git branch --show-current
# 如不在 test 分支
git checkout test
工作流程
# 1. 开发
git checkout test
# 编写代码
git push origin test
# 2. 发布
git checkout main
git merge test
git tag vX.Y.Z
git push origin vX.Y.Z
# 3. 部署
git checkout prod
git merge main
git 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 确保格式正确：
git commit -m "$(cat <<'EOF'
Commit message here.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
EOF
)"
质量保证
测试要求
- 核心业务逻辑必须有单元测试
- 使用真实数据测试，避免过度 mock
- 测试边界条件和错误场景
- 使用
go test -race检测竞态条件
代码审查
- 所有合并到 main 的代码必须经过审查
- 检查错误处理是否完善
- 检查是否有资源泄漏（goroutine、文件句柄）
- 检查并发安全性