| name | git-commit-standardizer |
| description | 分析 git 暫存區（staged）變更，依本專案既有慣例產出 Conventional Commits 風格的繁體中文 commit 訊息。當使用者要求「幫我寫 commit message」「產生提交訊息」「整理這次的 commit」「這次改動要怎麼寫 commit」或類似情境時使用此 skill。 |
| tools | Bash |
Git Commit Standardizer
當觸發此 skill 時：
- 執行
git diff --cached 分析暫存區變更（不猜測未暫存內容）。若暫存區沒有任何變更，提醒使用者先 git add 要提交的檔案，不要臆測變更內容。
- 依差異判斷
type、scope、subject、Release Note 分類與 QA 測試需求，以繁體中文產出結果。
格式約束（必須嚴格遵守）
- Header：
<type>(<scope>): <subject>（括號不可省略）
- QA 免測 Header：確認免測時，固定在 Header 結尾加上
(QA test free)；不得使用其他拼法或大小寫變體
- Allowed type：
feat, fix, docs, refactor, chore, test, style, perf, ci, other
other 保留給真的無法歸入其他 type 的變更（本專案既有歷史 commit 大量使用 other:），新 commit 應優先嘗試標準 type，只有明確歸不進去時才用 other。
- Subject：繁體中文、具體、不含空泛用語（「更新檔案」「修正問題」等），且 <= 50 字元
Release Note 與 QA 分類
每一則 commit message 都必須在 body 結尾輸出下列 Git trailer，供每週 Release Note 與 QA 清單自動彙整：
Release-Note: <user|qa|internal|none|review>
QA: <required|not-required|review>
Release-Note：user 表示列入使用者版、qa 表示僅供 QA、internal 表示 RD 內部紀錄、none 表示不列入、review 表示需人工確認。QA：required 時加上 QA-Area；not-required 時 Header 必須加上 (QA test free) 並加上 QA-Reason；review 時不得加免測標記。
判定原則
- 涉及 runtime code、UI、API、權限、資料處理、i18n、套件、環境設定、build 或部署行為，預設
QA: required；資訊不足時使用 QA: review。
- 只有純文件、註解、AI／RD 本地開發工具設定、測試工具等明確不進入產品執行路徑的變更，才可判定
QA: not-required。
- dependency、build、CI、environment 或部署腳本至少使用
QA: review，除非 staged diff 足以證明不影響產品與交付流程。
type 不等於 QA 或 Release Note 分類；混合變更採較高風險分類。
Scope 選擇規則
依 layout/ 底下的功能代碼分類，或依變更所在的共用層命名：
ac00 ~ ac13 對應功能代碼的核心 Gateway/後台管理畫面（例：ac01、ac05）
np01 ~ np05 對應功能代碼的其他編號模組
ai00 AI Gateway 相關（ai0001 ~ ai0005）
labs Labs 工具（labs/*、lb00/lb00xx）
shared src/app/shared/ 下的共用元件、pipe、directive
services src/app/shared/services/ 下的 api-*.service.ts 或其他共用服務
guard src/app/shared/guard/ 下的路由守衛
interceptor src/app/shared/Interceptors/ 下的 HTTP 攔截器
i18n src/assets/i18n/ 語系檔
models src/app/models/ 下的介面定義
config angular.json、environment.ts、tsconfig 等建置/環境設定
多處同時變更：選最核心或使用者最有感的模組作 scope。
Body
說明段落為選填；結尾的 Release-Note 與 QA trailers 為必填。Header 與 body 之間空一行。
預設輸出
預設輸出純 commit message 文字：
<type>(<scope>): <subject>
<body（選填）>
Release-Note: <user|qa|internal|none|review>
QA: <required|not-required|review>
<QA-Area 或 QA-Reason（依 QA 分類填寫）>
若使用者明確要求可執行指令，才改輸出：
git commit -m "<type>(<scope>): <subject>" -m "Release-Note: <分類>
QA: <分類>"
若為 QA: required 或 QA: not-required，可執行指令的最後一個 -m 也必須分別包含 QA-Area 或 QA-Reason。
不要主動執行 git commit，除非使用者明確要求你直接送出提交。
範例
fix(ac05): 修正 Job 排程時間計算邏輯，避免跨時區誤判feat(ai00): 新增 AI Prompt Template 使用者自訂設定頁docs(config): 補充 PrimeNG MCP 使用說明 (QA test free)
免測範例的 body：
Release-Note: internal
QA: not-required
QA-Reason: 僅修改 RD 開發文件，不影響產品執行行為
