commit
強制執行 Sentry 風格的規範化提交、分支安全檢查以及結構化問題參考,適用於 AI 編碼代理。
簡介
此技能作為版本控制操作的嚴格守門人,確保所有代碼提交均符合 Sentry 的工程標準。它專為在必須維護乾淨、可搜索且具備問題連結之提交歷史的環境中工作的開發人員與 AI 代理所設計。透過攔截提交請求,該技能可防止直接提交至 main 或 master 等受保護分支,並強制要求使用功能分支,從而保障儲存庫的完整性。
-
自動強制執行規範化提交格式,包含類型、範圍、主旨、正文與頁尾部分。
-
在執行任何提交操作前,透過檢查當前 git 狀態來驗證分支安全性。
-
支援諸如 Fixes SENTRY-1234、Fixes #1234 或 Refs LINEAR-ABC-123 等參考格式,實現無縫的問題追蹤。
-
標準化 feat、fix、ref、perf、docs 與 chore 等提交類型,確保元數據分類一致。
-
對主旨行實施嚴格的語法規則,要求使用祈使語氣與現在時態,且不得包含句點。
-
為 Claude Code 等 AI 助手生成的變更提供自動化的 Co-Authored-By 歸屬支援,在維持透明度的同時避免冗長的對話雜訊。
-
在進行任何提交邏輯之前,請務必使用 git branch --show-current 驗證當前分支。
-
若代理處於受保護分支,請使用 create-branch 技能安全地切換至開發環境。
-
將提交訊息的所有行控制在 100 個字元以內,以確保與標準 git 檢視器與 CLI 工具的兼容性。
-
訊息正文應聚焦於「做什麼」與「為什麼」而非實作細節,為日後的代碼審查提供清晰背景。
-
請勿在提交訊息中使用如「由 AI 生成」等非標準標記;嚴格遵守要求的 Co-Authored-By 頁尾格式。
-
每當與 git 工作流互動(包含 git commit、儲存變更或準備發佈說明)時,請務必使用此技能。
倉庫統計
- Star 數
- 35,602
- Fork 數
- 5,839
- Open Issue 數
- 2
- 主要語言
- Python
- 預設分支
- main
- 同步狀態
- 閒置
- 最近同步時間
- 2026年4月29日 上午06:03