建立 Git Commit

工作流程

1. 收集資訊

若有 Staged 的變更：

git diff --staged
git log --oneline -10

若沒有 Staged 的變更：

git diff
git log --oneline -10

2. 判斷

從過去的 Commit 歷史紀錄判斷以下項目。若無法判斷，請向使用者確認。

語言判斷

風格判斷

Scope 判斷

判斷過去 10 筆 Commit 是否包含 Scope（例如：feat(auth):)。

若包含，使用以下指令取得 Scope 列表：

git log --oneline -100 | sed -n 's/^[a-f0-9]* [^(:]*(\([^)]*\)):.*/\1/p' | tr ',' '\n' | sed 's/^ *//' | sort -u | xargs | sed 's/ /, /g'

3. 產生 Commit Message

根據判斷結果產生 Commit Message。

• 標題（第一行）: What（做了什麼）的簡潔說明，50 字元以內
• 內文（Body）: Why（為什麼這麼做）的補充說明
• 程式碼參考: 提及程式碼或路徑時，使用反引號（`）包起來
• 語言: 配合判斷出的語言
• 風格: 遵循判斷出的風格（Conventional Commits）
• Scope: 從 Scope 列表中選擇合適的項目（若適用）

4. 呈現與確認

將產生的 Commit Message 呈現給使用者確認。

格式範例：

建議的 Commit Message:

feat(user): 新增使用者大頭貼上傳功能

- 實作上傳 API endpoint
- 新增圖片格式驗證

詢問使用者是否滿意，或是否需要修改。

5. 執行提交 (可選)

如果使用者確認滿意，可以使用以下指令協助提交：

git commit -m "feat(user): 新增使用者大頭貼上傳功能" -m "- 實作上傳 API endpoint" -m "- 新增圖片格式驗證"