Agent Skills
› NeverSight/learn-skills.dev
› conventionalcommits
conventionalcommits
GitHub提供符合 Conventional Commits v1.0.0 规范的提交信息指南，支持语义化版本控制、Changelog 生成及自动化发布。涵盖提交结构、类型映射（如 feat/fix）、破坏性变更标记及具体示例，用于规范 Git 历史并辅助工具链处理。
Trigger Scenarios
编写 Git 提交信息
配置 Commit Lint 规则
自动化软件发布流程
Install
npx skills add NeverSight/learn-skills.dev --skill conventionalcommits -g -y
SKILL.md
Frontmatter
{
"name": "conventionalcommits",
"metadata": {
"author": "froQ",
"source": "Generated from https:\/\/github.com\/conventional-commits\/conventionalcommits.org, scripts at https:\/\/github.com\/0froq\/skills",
"version": "2026.3.25"
},
"description": "Conventional Commits specification for semantic versioning and changelog generation. Use when writing commit messages, configuring commit linting, or automating releases."
}
Conventional Commits
Based on Conventional Commits v1.0.0. A lightweight convention for writing commit messages that communicates intent and enables automated tooling.
The Conventional Commits specification provides a structured format for commit messages. It supports semantic versioning, changelog generation, and clearer project history.
Core Concepts
| Topic | Description | Reference |
|---|---|---|
| Structure | Type, scope, description, body, footer format | core-structure |
| Types | feat, fix, and optional type conventions | core-types |
| SemVer Mapping | How commits translate to version bumps | core-semver |
| Format Details | Scopes, bodies, footers, breaking changes | core-format |
Quick Reference
Commit Structure
<type>(<scope>): <description>
<body>
<footer>
Types and SemVer
| Type | SemVer | Use For |
|---|---|---|
feat |
MINOR | New features (normative per spec) |
fix |
PATCH | Bug fixes (normative per spec) |
docs |
— | Documentation changes (convention) |
refactor |
— | Code restructuring (convention) |
perf |
— | Performance improvements (convention) |
test |
— | Test additions/changes (convention) |
build |
— | Build system changes (convention) |
ci |
— | CI configuration (convention) |
style |
— | Code style changes (convention) |
Note: Only feat, fix, and breaking-change markers have normative SemVer meaning in the specification. Other types are optional conventions—tools may categorize them differently. chore is intentionally excluded from recommendations; use specific types above for clarity.
Breaking Changes
feat(api)!: redesign user authentication
BREAKING CHANGE: auth token format changed from JWT to opaque tokens
Examples
# New feature
feat: add dark mode toggle
# Bug fix with scope
fix(auth): resolve token expiration bug
# Breaking change
feat(api)!: remove deprecated endpoints
# With body and footer
feat(search): implement fuzzy matching
Adds Levenshtein distance algorithm for typo-tolerant search.
Closes #123
Version History
- e0220ca Current 2026-07-05 20:28
