Agent Skills
› NeverSight/learn-skills.dev
› commit-message
commit-message
GitHub自动根据 git diff 生成 Conventional Commits 格式的提交信息。支持智能拆分多类型变更、处理 submodule 状态，并输出包含精确文件路径的完整 git 指令，禁止使用通配符添加文件。
Trigger Scenarios
用户输入「cm」
需要生成符合规范的 commit message
Install
npx skills add NeverSight/learn-skills.dev --skill commit-message -g -y
SKILL.md
Frontmatter
{
"name": "commit-message",
"description": "依據 git diff 自動產生 Conventional Commits 格式的 commit message 與完整 git 指令。 輸入「cm」時啟用。"
}
Commit Message 產生 Skill
流程
- 執行
git diff --staged取得已暫存的變更 - 若暫存區為空，改執行
git diff HEAD - 分析變更內容，判斷變更類型與影響範圍
- 判斷是否需要拆分（見下方拆分邏輯）
- 依照輸出規則產生指令
若 project-status.yml 存在，讀取 api_status.submodule_path，api-status.yml 有變更時：
submodule_path不為空 → 從 diff 移除，最後單獨產生兩段 submodule commit 指令submodule_path為空 → 納入一般 commit，type 固定為chore- 不存在或無變更 → 略過
輸出規則
- 所有 git 指令必須放在 ```bash code block 內
- 禁止在 code block 外單獨出現任何指令或檔案路徑
- 說明文字寫在 code block 上方，以
#註解補充說明 - 不自動執行任何 git 操作，使用者自行複製執行
Commit Message 格式（Conventional Commits）
<type>(<scope>): <subject>
[optional body]
[optional footer]
Type 對照表
| type | 使用時機 |
|---|---|
| feat | 新增功能 |
| fix | 修正 bug |
| refactor | 重構，不影響功能 |
| docs | 文件變更 |
| style | 格式調整，不影響邏輯 |
| test | 新增或修改測試 |
| chore | 建置流程、依賴套件更新 |
| perf | 效能優化 |
規則
- subject 用祈使句，英文開頭小寫，不加句號
- subject 不超過 72 字元
- body 條列項目使用
-，不用* - 若變更跨多個模組，body 條列每個模組的變更摘要
- 若無法明確判斷 scope，省略不寫，不要猜測
- breaking change 在 footer 加上
BREAKING CHANGE: 說明
git add 規則
- 永遠列出明確的檔案路徑，包含從專案根目錄起的相對路徑
- 禁止使用
git add .或git add -A - 從 git diff 的結果推斷哪些檔案屬於此次變更
拆分邏輯
當變更同時包含以下任兩種以上，應拆分：
- 不同 type（例如 feat + fix）
- 不同 scope（例如 auth 模組 + db 模組）
- 不相關的檔案群組
情況 A：每個檔案只屬於單一群組
# Commit 1
git add src/user/avatar.ts src/user/upload.ts
git commit -m "feat(user): add profile picture upload"
# Commit 2
git add db/migrations/001_users.sql
git commit -m "fix(db): correct migration script for users table"
情況 B：同一檔案內混有不相關的變更
# src/api/handler.ts 同時包含 feat 與 fix 的變更
# 請先執行以下指令，逐一選擇要納入 Commit 1 的 hunk：
git add -p src/api/handler.ts
# 完成後執行：
git commit -m "feat(api): add user fetch endpoint"
# 再次執行，選擇剩餘的 hunk：
git add -p src/api/handler.ts
# 完成後執行：
git commit -m "fix(api): handle null response from gateway"
單一 commit 範例輸出
git add src/auth/GoogleOAuthProvider.tsx src/api/token.ts
git commit -m "feat(auth): add OAuth2 login with Google
- add GoogleOAuthProvider component
- implement token exchange endpoint
- store refresh token in httpOnly cookie"
Version History
- e0220ca Current 2026-07-05 21:38
