qcc-git

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 <[e-mail]>
EOF
)"

质量保证

测试要求

• 核心业务逻辑必须有单元测试
• 使用真实数据测试，避免过度 mock
• 测试边界条件和错误场景
• 使用 go test -race 检测竞态条件

代码审查

• 所有合并到 main 的代码必须经过审查
• 检查错误处理是否完善
• 检查是否有资源泄漏（goroutine、文件句柄）
• 检查并发安全性