managing-git-workflow

managing-git-workflow 技能是為 HASH 生態系統做出貢獻的開發人員的重要工具。它確保所有程式碼變更都能維持與 Linear 問題的嚴格可追溯性，這是專案任務管理與開發進度的主要事實來源。透過自動化 Git 規範驗證，此技能有助於維持乾淨、易於瀏覽的開發歷史，並確保團隊成員在程式碼審查期間遵守一致的溝通標準。

• 強制執行分支命名規範，使用 <shortname>/h-XXXX-description 模式將工作直接連結至 Linear 工單。

• 將提取請求 (Pull Request) 標題標準化為 H-XXXX: Description 格式，以提高整個儲存庫的可見度。

• 提供模板驅動的 PR 建立流程，確保目的、實作細節與合併前檢查清單得到系統化處理。

• 透過提供獲取完整 PR 元資料、拉取差異比較與檢查行內註解的特定指令，簡化程式碼審查過程。

• 與 gh (GitHub CLI) 等外部工具整合，確保審查人員同時具備來自 GitHub 與 Linear 問題追蹤器的必要背景資訊。

• 請確保您已設定 Linear MCP 伺服器，以便技能能夠使用 h-XXXX 識別碼直接獲取問題詳細資訊。

• 請務必使用位於 .github/pull_request_template.md 的 PR 模板，以確保涵蓋所有必需欄位，包括測試、演示素材與文件影響。

• 進行審查時，使用推薦的 gh api 指令來檢索完整差異比較與註解，而非使用截斷的摘要。

• 每當您啟動新任務、提交程式碼或審查同事的實作時，請使用此技能，以盡量減少合併過程中的阻力。

• 請特別注意 PR 標題需使用大寫 'H' 而分支名稱需使用小寫 'h' 的規定；此區別對於系統解析至關重要。

• 此技能充當護欄；如果您的工作流程偏離這些標準，它將提供即時的更正建議，協助您保持與團隊工程實踐的一致性。