git-commit-formatter

git-commit-formatter 是一款專為提升工程效率與確保 Git 儲存庫歷史記錄一致性而設計的工具。它提供了一套自動化且標準化的工作流程，用於產生符合 Conventional Commits 規範的提交訊息。透過直接整合至 Claude Code 環境，此技能確保每個 commit 都包含明確的祈使句摘要、變更動機說明以及必要的簽名標記，這對於專業軟體開發團隊與開源貢獻者至關重要。

• 自動透過 git status 與 git diff 分析已暫存與未暫存的檔案，為訊息提供相關背景資訊。

• 強制執行 Conventional Commits 標準 (feat, fix, docs, style, refactor, perf, test, chore) 以維持專案日誌的可讀性。

• 在每個 commit 中附加標準化的 Claude Code 簽名，確保作者身份與工具來源可靠。

• 採用基於 heredoc 的穩健提交執行方式，處理多行訊息，避免 shell 環境中的跳脫字元問題。

• 內建安全機制，防止意外暫存 .env 檔案或憑證等敏感資訊，並包含處理 pre-commit hook 失敗的邏輯。

• 互動式工作流程引導使用者區分不同類型的變更，協助將關注點分離至獨立的提交中。

• 非常適合需要維護嚴格提交歷史品質，並確保團隊成員遵守一致格式標準的開發者。

• 預期的輸入包含使用者的提交意圖與變更內容；技能會輸出結構化、格式化的 git commit 指令供執行。

• 在確認提交前，務必審查技能建議的 git diff，確保不相關的變更沒有被歸類在一起。

• 保持提交訊息第一行在 72 個字元以內，以維持 git log --oneline 檢視的相容性。

• 在呼叫此技能前，請確保敏感環境變數或大型二進位檔案未包含在暫存區中，以維持儲存庫安全性。