managing-git-workflow

Managing Git Workflow 技能為 HASH 儲存庫內部的代碼品質與專案可追蹤性提供了完整的框架。此技能專為 HASH 儲存庫的軟體工程師與開發者設計，確保他們的貢獻符合組織標準。透過自動化並引導本地開發與版本控制之間的交互，此技能降低了從任務執行到專案整合過程中的摩擦。

• 標準化分支命名規範，採用 <shortname>/h-XXXX-description 格式，強制要求將每次變更與特定的 Linear 票據連結。

• 強制執行結構化的 Pull Request (PR) 標題格式 (H-XXXX: Description)，以確保清晰的可追蹤性並簡化開發進度追蹤。

• 引導使用者落實官方 PR 模板，涵蓋目的、相關連結、實作細節以及合併前的強制檢查清單。

• 提供循序漸進的 PR 審核協定，包含用於取得完整差異檔、審核內嵌註解以及驗證 Linear 問題需求的命令列工具。

• 促進與 Linear 專案管理工具的整合，在進行環境感知代碼審核時呈現相關票據資訊。

• 在開發生命週期的每個階段使用此技能：包括初始化功能分支、編寫提交資訊、開啟 PR 或進行同儕代碼審核時。

• 輸入通常包含您的開發者 ID、目標 Linear 票據編號以及變更的描述性意圖。輸出為分支/PR 的格式化字串或自我驗證清單。

• 確保所有 PR 皆引用其關聯的 H-XXXX 票據編號，以維持儲存庫的整潔與歷史紀錄。

• 審核代碼時，利用提供的 Shell 指令（如 gh pr diff、gh pr view）以確保變更內容具有完整可見性，而非截斷的摘要。

• 在最終確認任何合併請求前，務必參考合併前檢查清單（涵蓋函式庫變更、文件與系統影響），以維持高信任度且安全的開發標準。