Claude Skills實戰02：我再也不寫"fix bug"了
整理版優先睇
用 Claude Code 嘅 commit-commands 技能，一條命令搞掂 Git 提交同 PR，告別繁瑣流程
呢篇文章係作者分享佢用 Claude Code 入面 commit-commands 技能嘅實戰經驗。作者係一個成日要處理 Git 操作嘅開發者，佢發現傳統嘅提交流程實在太麻煩：要逐個 git status、git add、git commit、git push，仲要另外開 PR，成日漏 file 或者寫唔好 commit message，浪費好多時間。佢想解決嘅問題就係點樣可以慳返呢啲步驟，減少人為失誤，令開發更專注。成個結論係：用呢個技能嘅三個命令，可以將原來 5-8 分鐘嘅操作縮短到 15-40 秒，而且 AI 生成嘅 commit message 同 PR 描述仲更加規範、完整。
三個命令分別係：/commit 負責自動分析 code diff、學習 repo 風格、生成規範 commit message 然後直接提交；/commit-push-pr 一條龍由創建分支到提交代碼再到開 PR，自動寫好 Summary 同 Test Plan；/clean_gone 就幫你清理本地已經合併咗嘅廢棄分支，唔洗再逐個手動刪除。作者仲用 Bug 修復、新功能開發同維護期清理三個場景做示範，對比傳統方式，效率提升好明顯。
總括嚟講，呢種自動化流程唔單止慳時間，仲可以提升 commit 同 PR 嘅質量。對於成日覺得 Git 操作好煩嘅開發者，呢個技能係一個實用嘅解決方案，值得試下。
- 傳統 Git 提交流程要 5-7 個步驟，容易漏 file 或者寫唔好 commit message，浪費時間。
- /commit 命令一條搞定自動 stage、生成規範 commit message 並直接提交，耗時 15 秒。
- /commit-push-pr 從提交到創建 PR 一條龍，自動生成完整 PR 描述同 Test Plan，效率提升 90%。
- /clean_gone 自動清理本地已合併嘅廢棄分支，5 秒搞掂，唔洗逐個刪到手軟。
- AI 生成嘅 commit message 同 PR 描述質量更高，而且會學習你 repo 嘅風格，保持一致規範。
commit-commands
Claude Code 嘅 commit-commands skill，提供 /commit, /commit-push-pr, /clean_gone 三個命令，簡化 Git 提交流程。
GitHub CLI
/commit-push-pr 需要用 gh CLI 創建 PR，安裝方法：brew install gh（macOS）或 winget install gh（Windows）。
結構示例
#
1. 查看變更git status#
2. 查看具體改動git diff#
3. 添加文件（經常漏這步）git add file1.py file2.py#
4. 寫commit message（經常寫得很敷衍）git commit -m "update"#
5. 推送到遠程git push#
6. 如果要開PR，還得...gh pr create# 然後手動填寫標題、描述、測試計劃...傳統 Git 流程嘅痛點
標準嘅 Git 提交流程要行 5-7 個命令：git status、git diff、git add、git commit、git push，如果要開 PR 仲要 gh pr create 同一大堆手動填寫。呢個流程唔單止慢，仲有 3 個好易錯嘅環節。
忘記 stage 文件
commit message 寫得太敷衍
PR 描述唔規範
作者話佢試過漏咗 file、commit message 寫「fix bug」、PR 求其寫一句就提交，過咗兩個月返轉頭睇已經唔記得做過啲乜。呢啲問題唔單止影響自己，亦影響團隊協作。
三個命令，解決所有 Git 煩惱
- /commit：一條命令搞掂日常提交，自動 stage 相關文件、生成 commit message、完成提交，耗時 15 秒。
- /commit-push-pr：適合新功能開發，自動創建 feature 分支、分析所有 commit、生成完整 PR 描述（包含 Summary 同 Test Plan），然後 push 同開 PR，一條命令搞掂。
- /clean_gone：PR 合併後本地殘留一堆 [gone] 分支，呢個命令會自動掃描、移除 worktrees 同刪除分支，5 秒清理曬。
傳統方式要 5-8 分鐘，而家 15 秒
AI 會學習你 repo 嘅 conventional commits 風格
自動跳過 .env 等敏感文件
實戰場景：Bug 修復、新功能、維護清理
作者用三個實際場景示範呢啲命令點樣幫手慳時間、減少失誤。
- 1 Bug 修復：用 /commit，15 秒搞掂，唔驚漏 file。
- 2 新功能開發：用 /commit-push-pr，30-40 秒一條龍，PR 描述自動有 Summary 同 Test Plan。
- 3 維護期清理：用 /clean_gone，5 秒清除所有已合併嘅廢棄分支。
/commit-push-pr 會自動生成 3-5 條 Summary 同完整 Test Plan
/clean_gone 一條命令代替手動 git branch -D 逐個刪
三個關鍵收穫，改變 Git 使用習慣
AI 生成嘅 commit message 比手寫更規範、更詳細
Claude 會分析 code diff，理解你改咗啲乜，再生成有意義嘅 message，仲會跟返 repo 嘅風格。對比手寫經常「fix bug」、「update」，AI 版本可以詳細到列出每一項改動。
自動化流程大幅減少人為失誤
唔再擔心漏 stage 文件、add 咗敏感文件、PR 描述寫得求其，呢啲煩惱全部由 AI 接管。
定期清理養成好習慣
以前覺得清理分支太麻煩，而家每星期行一次 /clean_gone，5 秒令本地倉庫乾乾淨淨，git branch 唔會再睇到眼亂。
夜晚11點，生產環境報錯。
緊急整好咗bug，準備提交code。開終端機，成個流程行一次：
git status
git add src/api/routers/strategy.py
git add src/strategy/strategy_manager.py
git commit -m "fix: bug"
git push
提交咗先發現：漏咗一個file，commit message又寫得太求其。
有時過咗兩個月睇返commit，已經完全唔記得自己開發咗啲咩功能。
呢個係「一天一個Claude Skill」系列第二期，今日講下點樣用一條command完成Git提交。本來想寫pdf嘅，但係覺得都係git呢個我用得比較多。
傳統Git流程：6步操作，3個容易錯嘅位
標準嘅Git提交流程係咁樣：
# 1. 查看變更
git status
# 2. 查看具體改動
git diff
# 3. 添加文件（經常漏這步）
git add file1.py file2.py
# 4. 寫commit message（經常寫得很敷衍）
git commit -m "update"
# 5. 推送到遠程
git push
# 6. 如果要開PR，還得...
gh pr create
# 然後手動填寫標題、描述、測試計劃...
容易出錯嘅3個環節：
唔記得stage file
git add漏咗file，搞到淨係提交咗部分改動或者唔小心add咗 .env呢啲敏感filecommit message唔規範
"fix bug"、"update"、「改咗一下」 睇唔出具體改咗啲咩 團隊規範唔統一 PR描述寫得求其
標題求其寫 描述留空或者得一句話 冇測試計劃
成個流程落嚟，3-5分鐘係常態。如果開PR，可能要5-8分鐘。
commit-commands：3個command搞掂所有問題
Claude Code嘅commit-commands skill提供咗3個command，覆蓋Git提交嘅所有場景。
1. /commit - 智能提交
最常用嘅command，一條搞掂日常提交。
佢做嘅嘢：
自動分析 git status和git diff睇最近10條commit，學習你嘅repo風格 生成規範嘅commit message 智能stage相關file（跳過敏感file） 完成提交
使用體驗：
# 你只需要輸入：
/commit
# Claude會：
# ✓ 分析你的代碼變更
# ✓ 生成這樣的commit message：
# "修復策略管理器空指針異常並添加參數校驗"
# ✓ 自動stage相關文件
# ✓ 完成提交
對比傳統方式：
2. /commit-push-pr - 一鍵開PR
功能開發完成，需要創建PR？一條command搞掂曬。
佢做嘅嘢：
檢查當前branch（如果喺main，自動創建feature branch） 提交code push到remote 使用 ghCLI創建PR自動生成完整PR描述（包含Summary同Test Plan）
使用體驗：
# 你只需要輸入：
/commit-push-pr
# Claude會：
# ✓ 創建feature分支（如果需要）
# ✓ 分析所有commit（不只是最新一條）
# ✓ 生成這樣的PR描述：
#
# ## Summary
# - 重構促銷系統禮券疊加邏輯
# - 修復優惠計算精度問題
# - 添加單元測試覆蓋核心場景
#
# ## Test plan
# - [ ] 驗證禮券疊加計算正確性
# - [ ] 測試邊界條件（0元訂單、超大折扣）
# - [ ] 檢查性能影響
#
# ✓ 提交、推送、創建PR
# ✓ 返回PR連結給你
對比傳統方式：
前提條件：
需要安裝GitHub CLI： brew install gh（macOS）或winget install gh（Windows）需要認證： gh auth login
3. /clean_gone - 清理廢棄branch
PR合併咗之後，remote branch刪咗，但係本地殘留一堆？用呢個。
佢做嘅嘢：
掃描所有標記為 [gone]嘅本地branch移除關聯嘅worktrees 刪除呢啲branch 報告清理結果
使用體驗：
# 你只需要輸入：
/clean_gone
# Claude會：
# ✓ 找到所有[gone]分支
# ✓ 移除worktrees
# ✓ 刪除分支
# ✓ 報告："已清理 5 個分支：feature/add-filter, feature/fix-bug..."
傳統方式要咁樣：
git branch -vv | grep gone # 手動查找
git branch -D feature/one # 逐個刪除
git branch -D feature/two
git branch -D feature/three
# ... 一個個刪到手痠
對比：
實戰場景演示
場景1：日常Bug修復
# ❌ 傳統方式（7個步驟）
git status
git add src/api/routers/strategy.py
git add src/strategy/strategy_manager.py
git commit -m "fix bug"
git push
# ✅ 使用/commit（1個步驟）
/commit
# Claude自動生成：
# "修復策略管理器空指針異常
#
# - 添加參數非空校驗
# - 更新錯誤處理邏輯
# - 補充邊界條件測試"
效率提升：85%
場景2：新功能開發完成
# ❌ 傳統方式（多個命令+手動填表單）
git checkout -b feature/add-filtering
git add .
git commit -m "add filtering feature"
git push -u origin feature/add-filtering
gh pr create
# 彈出編輯器，手動寫PR標題、描述、測試計劃...
# 經常偷懶只寫一行標題就提交了
# ✅ 使用/commit-push-pr（1個命令）
/commit-push-pr
# Claude自動：
# ✓ 創建feature分支
# ✓ 提交代碼
# ✓ push到remote
# ✓ 生成完整PR描述（3-5條Summary + 完整Test Plan）
# ✓ 返回PR連結
效率提升：90%
場景3：維護期清理 不過呢個我用得少
# 你的本地有10個已合併的分支殘留
# ❌ 傳統方式
git branch -vv | grep gone
# 看到一堆[gone]的分支
git branch -D feature/add-filter
git branch -D feature/fix-bug
git branch -D feature/update-deps
# ... 一個個複製粘貼刪除
# 10個分支，手動刪2-3分鐘
# ✅ 使用/clean_gone（1個命令）
/clean_gone
# Claude報告：
# "✓ 已清理 10 個廢棄分支"
# 耗時：5秒
效率提升：95%
3個關鍵收穫
1. AI生成嘅commit message質量更高
Claude會分析你嘅code diff，理解你改咗啲咩，然後生成描述準確嘅message。
對比：
# ❌ 手寫時經常這樣：
"fix bug"
"update"
"修改了一下"
# ✅ AI生成是這樣：
"修復促銷系統優惠券疊加計算錯誤
- 修正滿減券與折扣券組合邏輯
- 添加邊界條件判斷（0元訂單）
- 更新單元測試覆蓋新場景"
而且佢會學習你repo嘅風格，如果你嘅項目用Conventional Commits，佢都會跟。
2. 一鍵流程減少犯錯
人手操作最容易出錯嘅3個地方：
唔記得add某個file → Claude自動分析相關file 唔小心add敏感file（.env） → Claude會跳過 PR描述寫得求其 → Claude自動生成完整描述
自動化 = 減少人為失誤。
3. 定期清理保持倉庫整潔
/clean_gone令你養成定期清理嘅習慣。
傳統方式太麻煩，好多人懶得清理，結果git branch一睇幾十個branch，揾都揾唔到當前喺邊。
而家每週跑一次/clean_gone，5秒搞掂。
聽日預告
Claude Skills實戰03：feature-dev
由需求到實現嘅完整開發流程 自動生成架構設計同實現計劃 代碼審查同質量保證
你喺Git提交時最頭痛啲咩？係唔記得add file，定係寫唔好commit message？留言區講下你嘅痛點。
「一天一個Claude Skill」系列 - 每日一個實戰場景，幫你用啱工具、慳錢提效。
晚上11點，生產環境報錯。
緊急修復完bug，準備提交代碼。打開終端，一套流程打下來：
git status
git add src/api/routers/strategy.py
git add src/strategy/strategy_manager.py
git commit -m "fix: bug"
git push
提交完才發現：漏了一個文件，commit message也寫得太隨意。
有時候過了2個月看回commit，已經完全忘記自己開發了什麼功能。
這是"一天一個Claude Skill"系列第2期，今天聊聊怎麼用一條命令完成Git提交。本來想寫pdf的，但感覺還是git這個我用的更多一點
傳統Git流程：6步操作，3個易錯點
標準的Git提交流程長這樣：
# 1. 查看變更
git status
# 2. 查看具體改動
git diff
# 3. 添加文件（經常漏這步）
git add file1.py file2.py
# 4. 寫commit message（經常寫得很敷衍）
git commit -m "update"
# 5. 推送到遠程
git push
# 6. 如果要開PR，還得...
gh pr create
# 然後手動填寫標題、描述、測試計劃...
容易出錯的3個環節：
忘記stage文件
git add漏文件，導致只提交了部分改動或者不小心add了 .env這種敏感文件commit message不規範
"fix bug"、"update"、"改了一下" 看不出具體改了什麼 團隊規範不統一 PR描述寫得草率
標題隨便寫 描述留空或就一句話 沒有測試計劃
一套流程下來，3-5分鐘是常態。如果開PR，可能要5-8分鐘。
commit-commands：3個命令解決所有問題
Claude Code的commit-commands skill提供了3個命令，覆蓋Git提交的所有場景。
1. /commit - 智能提交
最常用的命令，一條搞定日常提交。
它做的事情：
自動分析 git status和git diff查看最近10條commit，學習你的repo風格 生成規範的commit message 智能stage相關文件（跳過敏感文件） 完成提交
使用體驗：
# 你只需要輸入：
/commit
# Claude會：
# ✓ 分析你的代碼變更
# ✓ 生成這樣的commit message：
# "修復策略管理器空指針異常並添加參數校驗"
# ✓ 自動stage相關文件
# ✓ 完成提交
對比傳統方式：
2. /commit-push-pr - 一鍵開PR
功能開發完成，需要創建PR？一條命令全搞定。
它做的事情：
檢查當前分支（如果在main，自動創建feature分支） 提交代碼 push到remote 使用 ghCLI創建PR自動生成完整PR描述（包含Summary和Test Plan）
使用體驗：
# 你只需要輸入：
/commit-push-pr
# Claude會：
# ✓ 創建feature分支（如果需要）
# ✓ 分析所有commit（不只是最新一條）
# ✓ 生成這樣的PR描述：
#
# ## Summary
# - 重構促銷系統禮券疊加邏輯
# - 修復優惠計算精度問題
# - 添加單元測試覆蓋核心場景
#
# ## Test plan
# - [ ] 驗證禮券疊加計算正確性
# - [ ] 測試邊界條件（0元訂單、超大折扣）
# - [ ] 檢查性能影響
#
# ✓ 提交、推送、創建PR
# ✓ 返回PR連結給你
對比傳統方式：
前提條件：
需要安裝GitHub CLI： brew install gh（macOS）或winget install gh（Windows）需要認證： gh auth login
3. /clean_gone - 清理廢棄分支
PR合併後，remote分支刪了，但本地殘留一堆？用這個。
它做的事情：
掃描所有標記為 [gone]的本地分支移除關聯的worktrees 刪除這些分支 報告清理結果
使用體驗：
# 你只需要輸入：
/clean_gone
# Claude會：
# ✓ 找到所有[gone]分支
# ✓ 移除worktrees
# ✓ 刪除分支
# ✓ 報告："已清理 5 個分支：feature/add-filter, feature/fix-bug..."
傳統方式要這樣：
git branch -vv | grep gone # 手動查找
git branch -D feature/one # 逐個刪除
git branch -D feature/two
git branch -D feature/three
# ... 一個個刪到手痠
對比：
實戰場景演示
場景1：日常Bug修復
# ❌ 傳統方式（7個步驟）
git status
git add src/api/routers/strategy.py
git add src/strategy/strategy_manager.py
git commit -m "fix bug"
git push
# ✅ 使用/commit（1個步驟）
/commit
# Claude自動生成：
# "修復策略管理器空指針異常
#
# - 添加參數非空校驗
# - 更新錯誤處理邏輯
# - 補充邊界條件測試"
效率提升：85%
場景2：新功能開發完成
# ❌ 傳統方式（多個命令+手動填表單）
git checkout -b feature/add-filtering
git add .
git commit -m "add filtering feature"
git push -u origin feature/add-filtering
gh pr create
# 彈出編輯器，手動寫PR標題、描述、測試計劃...
# 經常偷懶只寫一行標題就提交了
# ✅ 使用/commit-push-pr（1個命令）
/commit-push-pr
# Claude自動：
# ✓ 創建feature分支
# ✓ 提交代碼
# ✓ push到remote
# ✓ 生成完整PR描述（3-5條Summary + 完整Test Plan）
# ✓ 返回PR連結
效率提升：90%
場景3：維護期清理 不過這個我用得少
# 你的本地有10個已合併的分支殘留
# ❌ 傳統方式
git branch -vv | grep gone
# 看到一堆[gone]的分支
git branch -D feature/add-filter
git branch -D feature/fix-bug
git branch -D feature/update-deps
# ... 一個個複製粘貼刪除
# 10個分支，手動刪2-3分鐘
# ✅ 使用/clean_gone（1個命令）
/clean_gone
# Claude報告：
# "✓ 已清理 10 個廢棄分支"
# 耗時：5秒
效率提升：95%
3個關鍵收穫
1. AI生成的commit message質量更高
Claude會分析你的代碼diff，理解你改了什麼，然後生成描述準確的message。
對比：
# ❌ 手寫時經常這樣：
"fix bug"
"update"
"修改了一下"
# ✅ AI生成是這樣：
"修復促銷系統優惠券疊加計算錯誤
- 修正滿減券與折扣券組合邏輯
- 添加邊界條件判斷（0元訂單）
- 更新單元測試覆蓋新場景"
而且它會學習你repo的風格，如果你的項目用Conventional Commits，它也會遵循。
2. 一鍵流程減少犯錯
人工操作最容易出錯的3個地方：
忘記add某個文件 → Claude自動分析相關文件 不小心add敏感文件（.env） → Claude會跳過 PR描述寫得潦草 → Claude自動生成完整描述
自動化 = 減少人為失誤。
3. 定期清理保持倉庫整潔
/clean_gone讓你養成定期清理的習慣。
傳統方式太麻煩，很多人懶得清理，結果git branch一看幾十個分支，找都找不到當前在哪。
現在每週跑一次/clean_gone，5秒搞定。
明天預告
Claude Skills實戰03：feature-dev
從需求到實現的完整開發流程 自動生成架構設計和實現計劃 代碼審查和質量保證
你在Git提交時最頭疼什麼？是忘記add文件，還是寫不好commit message？評論區聊聊你的痛點。
"一天一個Claude Skill"系列 - 每天一個實戰場景，幫你用對工具、省錢提效。