Git Commit Skill

建立 Git commit 前執行完整的檢查流程。

執行流程

階段 1：程式碼品質檢查

1. Ruff Linting

   • 執行 uv run ruff check src/
   • 若有錯誤，先修復再繼續

2. Ruff Format

   • 執行 uv run ruff format src/
   • 確保程式碼格式符合規範

3. 執行測試

   • 執行 uv run pytest tests/ -v --tb=short
   • 若測試失敗，停止流程並報告

階段 2：Code Review

4. 檢視變更內容

   • 執行 git diff --stat 了解變更範圍
   • 執行 git diff 詳細檢視變更

5. Code Review 檢查清單 針對每個變更的檔案，檢查：

   • 程式碼邏輯是否正確
   • 是否有潛在的 bug 或邊界情況未處理
   • 是否有安全性問題（如 SQL injection、XSS、硬編碼密碼等）
   • 命名是否清晰、符合專案慣例
   • 是否有不必要的重複程式碼
   • 錯誤處理是否完整
   • 是否有遺漏的 logging 或過多的 logging

6. 若發現問題

   • 列出問題清單
   • 詢問使用者是否要修復後再提交

階段 3：準備 Commit

7. 查看 Git 狀態

   • 執行 git status 確認要提交的檔案
   • 執行 git log --oneline -5 了解 commit message 風格

8. 建立 Commit

   • 將相關檔案加入暫存區
   • 根據變更內容撰寫 commit message
   • 遵循專案的 commit message 風格
   • 使用 HEREDOC 格式確保訊息格式正確

Commit Message 格式

<type>: <簡短描述>

<詳細說明（若需要）>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Type 類型：

• feat: 新功能
• fix: Bug 修復
• refactor: 重構（不改變功能）
• docs: 文件更新
• test: 測試相關
• chore: 雜項（設定、建置等）
• perf: 效能優化

完成後回報

✅ 檢查結果

• Ruff linting 通過
• Ruff format 通過
• 測試通過
• Code Review 完成（無問題 / 已修復）

📝 Commit 資訊

• Commit hash: （提交後顯示）
• 變更檔案數:
• 變更摘要:

注意事項

• 不要執行 git push，除非使用者明確要求
• 若有未追蹤的重要檔案，詢問是否要加入
• 若使用者提供額外說明，可作為 commit message 的參考