Git Smart Commit — 智慧拆分提交

將目前所有 staged / unstaged 變更，依功能邏輯分群後，逐批

git add

git commit

流程

1. 檢查變更狀態

執行以下指令取得完整變更清單：

git status --short

若沒有任何變更，告知使用者「目前沒有需要提交的變更」後結束。

接著取得所有變更的 diff 內容（用來判斷分群邏輯）：

git diff
git diff --cached

2. 分析並分群

根據以下維度，將檔案變更分成多個 commit 群組，每組代表一個獨立的邏輯單元：

分群依據（優先順序）

package.json

vite.config.*

.gitignore

README.md

tsconfig.json

src/data/*.js

src/constants/*

src/config/*

src/components/Hero.jsx

src/pages/*

src/routes/*

src/App.jsx

src/index.css

src/styles/*

src/theme/*

src/utils/*

src/hooks/*

src/types/*

__tests__/*

*.test.*

*.spec.*

docs/*

*.md

分群規則

• 同一元件的 JSX/TSX + CSS Module + 測試 → 歸為同一組
• 相關的資料檔如果是為某個元件服務 → 可考慮合併或獨立，取決於變更量
• 若某一組只有 1 個檔案且改動極小（< 5 行）→ 合併到最相關的鄰近組
• 新增檔案用

  feat

  ，修改用

  fix

  /

  refactor

  /

  style

  ，刪除用

  chore

3. 產出 Commit 計畫

在執行任何 git 操作之前，先列出計畫讓使用者確認：

📋 Commit 計畫（共 N 個 commit）

1. chore(project): 初始化專案設定與相依套件
   → package.json, vite.config.js, .gitignore

2. feat(data): 新增首頁各區塊的設定資料
   → src/data/navigation.js, src/data/hero.js, ...

3. feat(navbar): 新增 Navbar 元件（含 RWD 漢堡選單）
   → src/components/Navbar.jsx

...

確認執行？(Y/n)

使用

notify_user

4. 逐批執行 Commit

使用者確認後，對每一組依序執行：

git add <file1> <file2> ...
git commit -m "<type>(<scope>): <subject>"

Commit Message 格式

<type>(<scope>): <簡短描述，繁體中文>

type 對照表：

feat

fix

style

refactor

chore

docs

test

scope 規則：

• 元件：用元件名稱小寫，例如

  hero

  ,

  navbar

  ,

  pricing

• 資料層：

  data

• 全域樣式：

  style

• 專案設定：

  project

• 多個範圍：用最主要的一個，不要用斜線串接

subject 規則：

• 使用繁體中文
• 不超過 50 字
• 不以句號結尾
• 用「動詞開頭」：新增、調整、修正、移除、重構

5. 確認結果

所有 commit 完成後，執行：

git log --oneline -20

將結果展示給使用者，確認所有 commit 都已正確建立。

邊界情況處理

• 有衝突或 merge 狀態：提醒使用者先解決衝突，不執行任何操作
• 有

  .env

  或敏感檔案：提醒使用者確認是否應被 gitignore，不自動提交
• 變更量極大（> 50 個檔案）：先產出分組摘要，請使用者確認後再執行
• 使用者已有部分 staged 變更：尊重已 staged 的狀態，將其視為一個獨立群組或合併到最相關的群組