Generate conventional commit messages with automatic language style detection.
<type>[optional scope]: <subject>
<body>
[optional footer]
Types: feat fix docs style refactor perf test build ci chore revert
Rules:
Refs #123, BREAKING CHANGE: ..., etc. Omit if not applicable.Default (full template): Always provide a complete commit command with type, scope, subject, body, and footer. This is the standard behavior unless the user requests otherwise.
git commit -m "$(cat <<'EOF'
<type>(<scope>): <subject>
<body>
<footer>
EOF
)"
Short mode: Only when the user explicitly says "简短一点", "只给 commit message", "只给命令", or similar brevity requests — output just the one-line subject:
git commit -m "<type>(<scope>): <subject>"
Detect project language from multiple signals (in priority order):
git log -20 --oneline| Style | Format Example |
|---|---|
| ------- | --------------- |
| English | feat(api): add user authentication endpoint |
| Chinese | feat(用户管理): 添加登录功能 |
Language Rules:
feat, fix, refactor, etc.)Run these in parallel to gather context:
git status
git diff --staged # staged changes (primary)
git diff # unstaged changes (fallback if nothing staged)
git log -20 --oneline # recent commits for language + style detection
If nothing is staged and nothing is unstaged, check:
git diff HEAD~1 # show last commit changes
Before generating, check if the project has commit conventions:
.github/COMMIT_CONVENTION.md, CONTRIBUTING.md, or similarPriority: project convention > keyword matching > file pattern matching
| Pattern | Type |
|---|---|
| --------- | ------ |
.test., .spec., __tests__/, *Test.java | test |
package.json, *.lock, Dockerfile, Makefile, pom.xml, build.gradle | build |
.github/, .gitlab-ci.yml, Jenkinsfile, *.yml (CI config) | ci |
.md, docs/, README, CHANGELOG* | docs |
| Only whitespace/formatting changes | style |
| Keywords: fix/bug/resolve/repair/patch | fix |
| Keywords: add/implement/create/introduce/support | feat |
| Keywords: refactor/extract/reorganize/restructure | refactor |
| Keywords: optimize/cache/performance/speed | perf |
| Keywords: update/upgrade/bump (dependencies) | chore |
| Keywords: revert/undo | revert |
| Mixed or unclear | chore |
Extract scope from changed file paths:
Strategy: Use the most meaningful directory name under src/ or project root.
| Path Pattern | Scope |
|---|---|
| ------------- | ------- |
src/api/user/, server/api/ | api or user |
src/components/Button/* | Button or components |
src/views/目标管理/* | 目标管理 |
src/utils/, src/lib/ | utils |
| Root config files only | omit scope |
| Mixed across many modules | omit scope or use broad scope |
Rules:
The body must answer what changed and why, not how. Structure:
1. 2. 3.), each item specifies the file/module and the changeWhen changes break backward compatibility:
! after type/scope: feat(api)!: change response formatBREAKING CHANGE: When changes include multiple distinct categories (for example: docs + fix + feat), the skill will split them into multiple commits by responsibility and present a batch of commit commands for user approval.
Behavior:
git add + git commit command using HEREDOC.mixed group and flag for interactive review.style commit to avoid noise.Confirmation step:
git commands until explicit user approval is given.Example (two commits):
# Commit 1 - bug fix
git add src/payment/*.ts
git commit -m "$(cat <<'EOF'\nfix(payment): 修复订单金额计算错误\n\n1. 调整 OrderService.calculateTotal 中折扣优先级，先应用商品折扣再叠加优惠券。\n2. 新增 utils/discount.ts 及单元测试。\n\nFixes #456\nEOF\n)"
# Commit 2 - docs
git add docs/CHANGELOG.md README.md
git commit -m "$(cat <<'EOF'\ndocs: 更新变更日志和 README\n\n1. 增加 2026-06-08 发布条目。\nEOF\n)"
Always await user approval before executing any of the above commands.
git commit -m "$(cat <<'EOF'
feat(用户管理): 添加登录功能
1. AuthService 实现基于JWT的用户认证，支持登录和登出。
2. TokenManager 添加令牌刷新机制和会话管理。
3. routes/auth.ts 更新API路由增加认证中间件。
关联 #123
EOF
)"
git commit -m "$(cat <<'EOF'
feat(api): add user authentication endpoint
1. Implement JWT-based authentication in AuthService for login/logout.
2. Add token refresh mechanism and session management in TokenManager.
3. Update routes/auth.ts with authentication middleware.
Closes #123
EOF
)"
git commit -m "$(cat <<'EOF'
fix(支付模块): 修复订单金额计算错误
问题：当商品包含折扣时，总价计算未考虑优惠券叠加，导致金额偏高。
修复：OrderService.calculateTotal() 中调整折扣优先级，先应用商品折扣再叠加优惠券。
新增：utils/discount.ts 添加折扣计算工具函数及对应单元测试。
Fixes #456
EOF
)"
git commit -m "$(cat <<'EOF'
feat(api)!: 更改用户接口响应格式
将用户列表接口的响应结构从数组改为分页对象，包含 data、total、page 字段。
前端分页组件需同步更新以适配新格式。
BREAKING CHANGE: GET /api/users 响应格式从 User[] 变为 { data: User[], total: number, page: number }，所有消费该接口的客户端需更新解析逻辑。
EOF
)"
git commit -m "$(cat <<'EOF'
revert: 回退用户头像上传功能
回退 commit abc1234 中引入的头像上传功能，原因是文件存储服务迁移中，
待迁移完成后重新引入。
Refs #789
EOF
)"
git commit -m "feat(api): add user authentication endpoint"
--no-verify unless explicitly requestedgit add over git add . — avoid accidentally staging sensitive files.env, credentials, or large binaries共 3 个版本