commit-safe

commit-safe 技能是專為 Git 工作流程設計的智慧助手，旨在透過強制執行嚴謹的暫存實踐來提升代碼品質與透明度。它非常適合在 Git 管理的儲存庫中工作，並希望避免使用「git add -A」或「git add .」等可能導致提交過大或誤入敏感檔案的軟體工程師與技術研究人員使用。透過監控工作目錄的狀態，此代理會主動提供有關檔案暫存、提交結構化以及遵循語意化提交規範的指導。

• 主動攔截潛在的批次暫存操作，並建議在完成提交前透過 git status 與 git diff --stat 檢視變更。

• 強制執行清晰的語意化提交訊息規範（例如：feat, fix, docs, refactor, test），確保 Git 歷史記錄乾淨且易於搜尋。

• 提供透過自訂 Shell 腳本（scripts/commit.sh）的封裝介面，確保所有提交皆已簽署並正確標記。

• 鼓勵將相關變更進行邏輯分組，促進原子化提交（atomic commits），讓代碼審查更高效。

• 在偵測到多檔案修改或高風險儲存庫狀態時，提供即時的操作建議。

• 適用於對提交記錄整潔度要求極高的研究模板或專業開發環境。

• 嚴格禁止提交如 .env 或本地憑證檔等敏感資訊，並透過前置確認機制進行防護。

• 要求開發者明確暫存特定檔案，有效地將複雜變更拆解為更小、易於管理的區塊。

• 運作機制為監控工作樹變更，並在暫存操作發生前與使用者互動以確認其意圖。

• 建議與項目自有的提交處理腳本整合使用，以防止 AI 簽名洩漏並維護標準化的文件編寫標準。