在 develop 上提交變更
每次提交都對應一個版本。CONTRIBUTING.md 中的規則(「每次提交」);簡要說明如下:
- 驗證。 執行
yarn verify(型別檢查、Lint 零警告、Prettier 檢查、測試、含預渲染的建置)。修正程式碼本身,而非繞過規則:若要例外,必須在--後面加上單行停用與原因說明。 - 檢查工作目錄。 執行
git status。使用者可能還有未完成的編輯:僅列出此變更有更動的檔案。其餘檔案保持未暫存狀態。 - 提交前選擇版本號(讀取
package.json中的version以及CHANGELOG.md的開頭,且是現在的最新值,而非之前的值):- major:移除或重新命名頁面、改變網址、重新設計
- minor:新增可見內容或功能
- patch:修正、文案、圖片、樣式、依賴、設定、測試、文件
- 更新變更日誌。 在唯一的
## Unreleased標題下方新增### X.Y.Z - YYYY-MM-DD(若此標題在釋出後已消失,則將其加在最新的## Release上方),並包含Added/Changed/Fixed/Removed群組,每個群組為一行純文字,僅使用短連字符。 - 提交 列出的檔案 (按名稱):執行
git commit -- <files>,主旨為<變更內容(祈使句) (X.Y.Z)>,加上簡短說明內文,若由 Claude 撰寫則加上共同作者標記。 - 檢查提交 核對訊息:執行
git show --stat HEAD。然後推送至develop。
在提交之前,請列出每個變更的單元(檔案、函式、分支),並標明涵蓋該單元的測試。若有未經測試的分支,必須補上測試,或在回覆中附註說明。