commit

此技能作為 git 操作的嚴格守門人，確保所有代碼提交均符合 Sentry 工程標準。它專為在專業軟體環境中工作的開發人員和 AI 代理而設計，在這些環境中，儲存庫衛生、提交可追溯性和分支保護至關重要。通過集中提交過程，它可以防止意外直接推送至 main 或 master 等受保護分支，並強制執行一致的、機器可讀的歷史記錄，從而簡化調試和審計過程。該技能利用特定邏輯驗證當前 git 分支，必要時強制創建功能分支，並將提交訊息結構化為強制性的標頭-主體-頁尾格式。

• 自動觸發 git 提交和保存變更工作流的檢查。

• 通過防止在 main 或 master 分支上直接提交（除非明確要求）來強制執行分支安全。

• 強制執行規範化提交類型，包括 feat、fix、ref、perf、docs、test、build、ci、chore、style、meta 和 license。

• 強制執行嚴格的主題行規則：祈使語氣、現在時、末尾無句號，且限制在 70 個字符內。

• 使用標準化的 Fixes 或 Refs 前綴自動化 Sentry、GitHub 或 Linear 的問題參照。

• 注入 AI 生成代碼的強制性 Co-Authored-By 署名，以保持透明度，同時不增加非標準的提交噪音。

• 實施強制性的標頭-主體-頁尾結構，每行限制在 100 個字符以內。

• 在提交之前，務必使用 git branch --show-current 驗證當前分支。

• 如果在受保護的分支上，請使用 create-branch 技能安全地移動到新的開發環境。

• 確保提交訊息描述變更的「內容」和「原因」，而不是「如何」實現。

• 僅使用允許的提交類型列表，以維護儲存庫語義版本控制和變更日誌的完整性。

• 如果缺乏問題參照或分支狀態不清，請停止執行。