提交訊息
格式:<類型>(<可選範圍>): <摘要>
- 類型:
feat、fix、refactor、perf、test、docs、style、chore、build、ci。 - 摘要:英文、祈使語氣(使用「add」而非「added」)、小寫開頭、無結尾句點、最多 72 字元。
- 主體(可選):摘要後空一行,說明原因,每行 72 字元換行。
- 重大變更:在類型後加上
!,並在頁尾加上BREAKING CHANGE:。 - 一個邏輯變更對應一個提交。僅暫存屬於該提交的檔案;切勿盲目使用
git add -A。
任務完成時
如果任務更改了檔案,請在回覆結尾提供可複製的建議提交:
<類型>(<範圍>): <摘要>
<原因,1-3 行,僅在摘要不足以說明時使用>
- 以此任務觸及的檔案之
git diff為基礎,而非工作目錄中其他不相關的變更。 - 真正分離的變更(例如一個錯誤修正和一個 UI 重新命名)應分別提出一個建議提交,並在每個提交下列出所屬的檔案。
- 僅提出建議。除非使用者要求,否則不要執行
git commit。
規則:
- 切勿加入
Co-Authored-By或「Generated with」字樣。 - 僅在使用者要求時才進行提交。除非使用者明確要求,否則切勿執行
git push。