工程開發
commit avatar

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
在 GitHub 查看