commit-messages

此技能為軟體開發人員提供了一個標準化工作流程，用於建立高品質、具描述性且一致的 git 提交訊息。透過分析 git diff --staged 的暫存變更，代理程式能識別修改的性質（例如功能新增、錯誤修復、重構或效能改進），並將其對應至 Conventional Commits 規範。這能確保儲存庫歷史保持簡潔、易讀，並可供自動化變更日誌生成與版本控制工具解析。

此技能專為需要在專業環境中遵守嚴格版本控制規範、且希望減輕手動起草訊息負擔的開發人員所設計。它能根據分析的程式碼上下文，智慧地建議適當的類型 (type) 與範圍 (scope)，有效彌補原始程式碼變更與專業專案文件之間的差距。

• 自動分析已暫存的 git diff 以總結程式碼變更。

• 強制執行 Conventional Commits 格式，包含類型、範圍、主旨行、內文與頁尾。

• 支援標準提交類型，如 feat, fix, docs, style, refactor, perf, test, build, ci, chore 及 revert。

• 遵守各項最佳實踐，例如祈使句語氣、最大行長度限制 (72 字元) 以及重大變更的適當格式。

• 支援議題引用，允許使用者將提交直接連結至 GitHub Issues 或 Jira 等追蹤系統。

• 提供互動式回饋機制，代理程式會顯示摘要、提議訊息，並允許使用者在最終提交前進行檢閱或修改。

• 使用說明：在觸發技能前，請務必先暫存您的檔案 (git add)，以確保代理程式能完整檢視變更。

• 適用於預提交階段 (pre-commit)、檢閱變更時或準備發布版本時。

• 輸入：Git 暫存變更；輸出：準備執行且格式化後的提交訊息字串。

• 實用建議：若代理程式建議的範圍不正確，請在後續提示中提供正確的上下文以提高準確性。

• 此工具是 Claude Code Mastery 工具包的核心元件，強調確定性的品質門檻與儲存庫標準強制執行。