Communitygithub.com

josepdecid/subtitle-flashcards

建立遵循 Conventional Commits 規範的 Git 提交,並可選擇是否在之後推送。當使用者要求提交變更或執行 /commit 時使用。

subtitle-flashcards 是什麼?

此技能為 AI 代理(如 Claude Code、Cursor、Codex)提供標準化的 Git 提交流程,確保每次提交都嚴格遵循 Conventional Commits 規範。它會自動檢查儲存庫狀態(使用 `git status --short`、`git diff --cached`、`git diff` 和 `git log --oneline -10`),並智慧地選擇要暫存的檔案,避免暫存不相關或敏感的檔案(如 `.env`、`.venv`)。提交訊息依格式包含類型(如 `feat`、`fix`)、選用範圍、描述、選用內文和結尾,並支援中斷變更標記。若使用者要求,它還可安全地執行推送,但絕不強制推送。此技能支援所有主流 AI 代理平台,透過減少手動操作和保證提交一致性來提升開發效率。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/josepdecid/subtitle-flashcards/tree/HEAD/.agents/skills/conventional-commit

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

工作流程

  1. 檢查儲存庫狀態:git status --short、git diff --cached 和 git diff。同時檢查 git log --oneline -10 以符合現有風格。
  2. 如果沒有暫存的變更,請透過明確的路徑暫存相關變更(避免使用 git add -A,以避免包含無關或敏感的檔案)。絕對不要暫存 .env、密鑰或 .venv。
  3. 如果變更涉及明顯無關的關注點,請將它們拆分為單獨的提交。
  4. 按照以下格式編寫訊息,然後使用 git commit 提交。
  5. 執行 git status 以確認提交成功。
  6. 僅當使用者傳遞 --push 時才推送:執行 git push(若未設定上游,請使用 git push -u origin <branch>)。絕不強制推送。

訊息格式

<類型>(<選用範圍>): <描述>

<選用內文>

<選用結尾>
  • 類型:feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert。
  • 描述:祈使語氣、小寫、結尾不加句號、最多約72個字元。
  • 範圍:受影響區域的簡短名詞(例如 cli、server、translate);如果不清楚,請省略。
  • 內文:解釋為何要這麼做,每行約72個字元;對於微不足道的變更,可省略。
  • 中斷變更:在類型/範圍後加上 !,並在結尾加上 BREAKING CHANGE:。

規則

  • 除非被要求,否則不要修改、重寫或重寫歷史記錄。
  • 不要跳過掛鉤(--no-verify)。
  • 如果掛鉤失敗,請修復問題並建立新的提交。
  • 如果沒有變更,請不要提交;而是告知使用者。

相關技能