generate-commit-message

generate-commit-message 技能是一款專為軟體工程師設計的自動化工具，旨在通過確保提交歷史的標準化與描述性來簡化版本控制工作流程。該工具通過直接與 Git 暫存區整合，分析當前的差異（排除不相關的元數據），進而合成關於程式碼變更的易讀摘要。它嚴格遵循 Conventional Commits 規範，強制執行包括類型、可選作用域及簡潔祈使句描述的結構。這有助於維持清晰且易於瀏覽的提交歷史，這對於長期專案維護與自動化變更日誌生成至關重要。

• 使用 git --no-pager diff 指令自動捕獲暫存區的程式碼變更進行處理。

• 強制執行 Conventional Commits 標準，支援 feat、fix、docs、style、refactor、perf、test、build 與 ci 等類型。

• 將提交訊息標題限制在 50 個字元以內，以確保在終端機日誌與 git 圖形介面中的可讀性。

• 要求描述語句採用祈使語氣，以確保意圖溝通明確。

• 減少開發人員在維護複雜儲存庫並需快速記錄增量變更時的手動負擔。

• 主要輸入為本地 git 儲存庫中暫存的變更集，輸出為一段純文字的提交訊息。

• 在呼叫代理程式之前，請務必正確暫存檔案 (git add)，以確保差異分析的準確性。

• 該工具會忽略 diff 輸出中的顏色資訊以防止解析錯誤，並確保無論終端機主題設定如何都能保持一致。

• 雖然工具會根據內容建議訊息，但其設計初衷是為了提升效率；在產生之前，請確保差異內容準確反映了變更背景。

• 限制條件包括最大字元數與固定格式，這確保了與 CI/CD 管線及自動化發布工具的相容性。