git-workflow

git-workflow 技能為管理 community-patterns 儲存庫的貢獻提供了一套嚴謹、標準化的流程。它專為在快速發展的專案中擔任貢獻者的軟體代理所設計，該專案高度依賴持續的變基（rebase）與系統化的拉取請求（PR）管理。透過強制執行一系列嚴格的操作—從主分支更新、分支變基，並利用 Git 的 force-with-lease 機制—該技能最大限度地減少了合併衝突，並確保所有提交的模式都能維護乾淨、線性的提交歷史，以利同行評審。它自動處理個人分叉（fork）與上游儲存庫之間的複雜互動，處理遠端配置、分支切換以及透過 GitHub CLI 產生拉取請求元資料的細節。

• 與上游儲存庫的自動同步，使用 fetch 與 rebase 協定確保本機環境保持最新。

• 整合式拉取請求建立流程，包含用於摘要、測試清單與功能描述的標準化模板。

• 對所有貢獻強制執行基於分支的開發流程，防止直接推送到主分支。

• 衝突解決協助，引導代理完成互動式變基階段，確保提交前的穩定性。

• 具備情境意識的遠端管理，根據工作區配置檔案區分個人分叉與直接儲存庫貢獻。

• 在提交工作前，務必使用 git status 確認目前分支狀態，以防止誤包含未追蹤的檔案。

• 嚴格遵守手動請求權限的要求；未經使用者明確授權，切勿自動建立拉取請求。

• 對推送功能分支時使用 force-with-lease，以避免覆蓋尚未抓取的遠端工作。

• 變基時若發生衝突，請務必記錄解決過程，並在嘗試推送更新的分支前確保變基作業正確繼續。

• 在 jkomoros/community-patterns 上游儲存庫進行開發時，務必使用 username/feature-name 慣例建立專屬功能分支，以利於清晰的 PR 追蹤。

• 根據社群嚴格的開發準則，優先使用變基而非合併，以維護乾淨的專案歷史。