推送
將變更提交並推送至目前分支。
此技能不限定於特定分支——它始終作用於目前檢出的分支。請根據您專案的提交歸屬偏好,調整下方第 8 步的尾部行。
快速開始
- 使用
git branch --show-current偵測目前分支。 - 若無目前分支名稱,請停止並顯示錯誤。
- 使用
git pull --ff-only origin <目前分支>拉取最新的origin/<目前分支>。若失敗,請停止並顯示錯誤。 - 在暫存前檢查差異。
- 若相關,優先使用
docs/change-log.md中最新且有意義的更新作為提交訊息來源。 - 若變更日誌更新並非變更的真正來源,則從差異中主要變更的區域推導訊息。
- 使用
git add -A暫存所有變更。 - 使用多行訊息提交,並附加專案的標準尾部行(通常為
Co-Authored-By:行或類似的歸屬文字;依專案而定)。 - 使用
git push origin <目前分支>推送。 - 以一句話報告分支、提交雜湊值與主旨。
提交訊息指引
使用簡潔的慣例式主旨,例如:
docs:適用於文件或路由更新feat:適用於新功能、系統或內容fix:適用於行為修正refactor:適用於結構性變更,不涉及重大行為改變test:適用於有意義的測試範圍新增或修改chore:適用於不適合其他分類的維護工作
對於正文:
- 總結最有意義的變更區域
- 每個主要變更偏好使用一行
- 保持基於實際差異
當使用 docs/change-log.md 作為來源時:
- 偏好使用最新且實際描述核心變更的章節或條目
- 當變更日誌更新是附帶性的,不要強制使用從變更日誌推導的訊息
當不使用變更日誌作為來源時:
- 從差異中最重要的變更區域推導主旨
- 若差異過於模糊,無法有把握地總結,請向使用者詢問提交訊息,而非猜測
規則
- 始終使用目前檢出的分支。
- 絕不使用
--force或--force-with-lease。 - 絕不使用
--no-verify。 - 明確失敗:若某一步驟失敗,請停止並顯示錯誤。