qcc-git

qcc-git 技能為 qcc_plus 專案的 Git 生命週期管理提供了結構化的框架。它專為需要維護程式碼品質並在多租戶代理服務架構下工作的開發人員、DevOps 工程師和貢獻者所設計。透過標準化分支策略與提交訊息，此工具確保自動化 CI/CD 管線能正確運作，並維持分散式環境中版本控制的乾淨度。

• 強制執行三層分支策略：test（日常開發/自動部署）、main（正式發布/打標籤）以及 prod（生產環境部署）。

• 實作「Conventional Commits」（例如 feat, fix, refactor 等）要求，以確保自動化變更日誌生成與版本相容性。

• 提供安全的 Git 執行協定，防止意外的強制推播（force push）、未經授權的設定變更，並確保符合程式碼審查規範。

• 整合基於 Shell 的 Git 工作流程，提供特定的 Bash 指令以實現無縫的分支切換與部署編排。

• 包含品質保證標準，例如單元測試要求、Go 競態條件（race）檢測，以及針對 goroutine 安全性與錯誤處理的嚴格審查清單。

• 開發人員在開始任何工作前，必須使用 git branch --show-current 確認當前分支正確。

• 提交訊息必須嚴格遵循 type: description 格式，以避免合併被拒絕。

• 開發人員應使用提供的 HEREDOC 範本進行所有提交，以與 Claude Code 的互動模式保持一致。

• 此工具旨在與專案的 .githooks 設定結合使用，以進行本地驗證。

• 請遵守提供的安全限制：絕不繞過掛鉤（hooks），並在推送變更前務必驗證作者身份。