適用於 Openclaw 的 Smart Commit

Smart Commit 是一款由 AI 驅動的 Git 工具,透過分析暫存區的變更,按照 Conventional Commits 標準生成精確且結構化的提交訊息。

wusuiling-if
v1.0.0
Mar 12, 2026
0
1k
0

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。

npx clawhub@latest install git-smart-commit

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

優先級:工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。

請幫我使用 Clawhub 安裝 git-smart-commit。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 Smart Commit?

Smart Commit 是 Openclaw Skills 生態系統中的專用工具,旨在消除手動編寫 Git 訊息帶來的摩擦。透過檢查暫存的差異(diffs),它能智慧識別程式碼變更的意圖——無論是新功能、錯誤修復還是效能優化——並將其格式化為標準化結構。

此技能可確保專案的版本歷史保持整潔、可搜尋且專業。它不僅能生成簡單的文字,還能偵測破壞性變更(breaking changes),並為過於複雜的差異建議邏輯拆分,是任何使用 Openclaw Skills 進行版本控制管理的開發者的必備資產。

Smart Commit 應用場景

  • 當開發者希望快速生成專業提交訊息而無需手動輸入時。
  • 當團隊要求嚴格遵守 Conventional Commits 規範以實現自動化更新日誌時。
  • 當暫存的變更較為複雜,需要 AI 驅動的摘要來識別主要影響時。
  • 當執行依賴更新(chore)或文件調整(docs)等日常維護時。

Smart Commit 運作原理

  1. 此技能執行 git diff --cached --stat 以獲取暫存修改的高層概覽。
  2. 透過 git diff --cached 對完整差異進行深度分析以理解邏輯變更。
  3. AI 選擇合適的類型(feat、fix、refactor 等),並根據檔案路徑推斷相關的範圍(scope)。
  4. 生成草稿訊息並提交給使用者審核。
  5. 批准後,此技能執行最終的 git commit -m 命令來完成變更。

Smart Commit 設定指南

要將此功能整合到您的工作流中,請確保您的 Openclaw 環境已配置,並在終端機中執行以下命令:

# 進入您的 Git 倉庫
cd your-project-repo

# 暫存您的變更
git add .

# 透過您的 AI 代理觸發 smart-commit 技能
openclaw run smart-commit

Smart Commit 資料結構與分類體系

Smart Commit 利用 Git 的內部中繼資料和 Conventional Commits 分類法來組織資訊:

元件 來源 描述
Type Diff Analysis 分類變更(例如:feat, fix, style)
Scope File Path 識別受影響的模組(例如:api, ui)
Subject Hunk Analysis 對變更的命令式描述
Breaking Change Code Impact 偵測破壞性 API 或邏輯變更

對於大型差異(超過 4000 行),它會基於 git diff --stat 生成摘要以維持 token 效率。

Smart Commit 進階特性

  • 破壞性變更偵測:自動在標題中添加 ! 並填充 BREAKING CHANGE: 頁尾。
  • 自定義範圍:能夠使用 --scope 和 --type 標誌強制指定特定範圍或類型。
  • 修正支援:使用 --amend 選項無縫更新最後一次提交訊息。
  • **演練模式 (Dry Run)**:在不執行提交命令的情況下查看生成的訊息以驗證準確性。
  • 大差異採樣:針對大規模變更集的智慧程式碼區段(hunk)採樣,確保上下文永不遺失。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*