conventional-commits
3
总安装量
3
周安装量
#58363
全站排名
安装命令
npx skills add https://github.com/cleanslice/skills --skill conventional-commits
Agent 安装分布
opencode
3
claude-code
3
github-copilot
3
codex
3
kimi-cli
3
gemini-cli
3
Skill 文档
Conventional Commits
Format
<type>[optional scope]: <description>
[optional body]
[optional footer(s)]
Types
| Type | When to use | SemVer |
|---|---|---|
feat |
New feature | MINOR |
fix |
Bug fix | PATCH |
docs |
Documentation only | â |
refactor |
Code change, no feature/fix | â |
test |
Adding or updating tests | â |
chore |
Maintenance, config, dependencies | â |
perf |
Performance improvement | â |
ci |
CI/CD changes | â |
build |
Build system changes | â |
style |
Formatting, whitespace | â |
revert |
Reverts a previous commit | â |
Scope
Use the slice name as scope: feat(user): add user CRUD functionality
Common scopes: slice names (user, auth, project), infrastructure (api, prisma, theme), or omit for cross-cutting changes.
Rules
- Description: imperative, present tense (“add” not “added”)
- No capital first letter
- No period at end
- Keep header under 72 characters
- Body starts with blank line after description
- Footers start with blank line after body
Breaking Changes
Add ! before the colon, or use a BREAKING CHANGE: footer (or both):
feat!: remove support for Node 6
feat: change config format
BREAKING CHANGE: `extends` key now works differently
Breaking changes always trigger a MAJOR version bump.
Examples
feat(user): add user CRUD functionality
fix(auth): handle token expiration correctly
refactor(project): extract validation into service
feat(api): add pagination to list endpoints
Support cursor-based pagination for all collection endpoints.
Default page size is 20 items.
Refs: #123
chore: update dependencies