菜单
Use when writing a git commit message or running git commit in zipe-spring-boot-starters. Commit subjects must be in 繁體中文 and follow the <類型>(<範圍>): <主旨> format with an allowed type and module scope.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | git-commit-message |
| description | Use when writing a git commit message or running git commit in zipe-spring-boot-starters. Commit subjects must be in 繁體中文 and follow the <類型>(<範圍>): <主旨> format with an allowed type and module scope. |
<類型>(<範圍>): <主旨>
<本文（選填）>
| 類型 | 說明 |
|---|---|
新增 | 新功能 |
修復 | 錯誤修復 |
重構 | 程式碼重構（不影響功能） |
測試 | 新增或修改測試 |
文件 | 文件更新 |
設定 | 設定檔、建構工具或依賴套件變更 |
效能 | 效能改善 |
移除 | 刪除程式碼或檔案 |
填入受影響的模組名稱，例如：base-starter、db-starter、job-starter、logon-starter、iam-starter、web-starter、web-service-starter、keycloak-starter、starters-example。若變更不限於單一模組（如升級全域依賴），可省略範圍，格式簡化為 <類型>: <主旨>。
新增(base-starter): 新增 AES-256 加解密工具
舊版 AesUtil 僅支援 AES-128，新增 AES-256 模式以符合資安規範。
修復(db-starter): 修正多資料來源切換後 ThreadLocal 未清除的問題
重構(job-starter): 將 QuartzJobUtil 拆分為獨立的排程生命週期管理類別
設定: 升級 Spring Boot 至 3.5.7
| 錯誤 | 修正 |
|---|---|
主旨用英文（如 fix: ...、feat: ...） | 改用繁體中文類型詞（修復、新增） |
| 類型不在允許清單內 | 僅能用上表八種類型 |
| 主旨超過 50 字、塞入「為什麼」 | 「為什麼」移到本文，主旨只寫「做了什麼」 |
| 本文與主旨之間沒空一行 | 兩者之間保留一行空白 |
Use when asked to publish, release, or deploy zipe-spring-boot-starters to Maven Central (e.g.「發布至 maven central」「出新版」「release 4.x.x.x」)。Covers the GitHub-Action-driven release flow, version/tag rules, branch flow, and pre-flight irreversibility checks.
Use when creating a new *-spring-boot-starter module, adding a new @AutoConfiguration class, or adding @ConfigurationProperties to any zipe-spring-boot-starters module — encodes the golden conventions a starter must follow so agents replicate the established pattern instead of drifting.
Use to audit all zipe-spring-boot-starters modules for convention drift against the authoring-a-starter golden rules — run periodically, before a release, or after adding a starter, to detect packages/naming/overridability/registration that diverge and propose fixes (harness entropy-management / garbage-collection principle).
Use when finishing a code change in any zipe-spring-boot-starters module and about to commit, push, or tell the user the work is done — especially after editing Java under any *-spring-boot-starter module.
Use when code changes are made to any zipe-spring-boot-starters module (base, db, job, logon, web-service, web, iam) or when the starters_example / example-kotlin example projects need updating. Triggers on new utilities, API changes, new login methods, new connection types, schedule changes, new REST/SOAP endpoints, or new features in any starter or example module.