За Conventional Commits Помощник — Подробно ръководство
Генераторът на Conventional Commits изгражда структурирани Git commit съобщения, следващи спецификацията Conventional Commits. Той води разработчиците през избора на тип (Type), обхват (Scope), тема (Subject), опционално подробно описание (Body) и препратки в долния колонтитул (Footer).
Лесно маркирайте чупещи съвместимостта промени чрез синтаксиса с удивителен знак (`type!: description`), реферирайте затворени задачи (`Closes #123`) и генерирайте стандартизирани съобщения за комити, които захранват автоматизирани инструменти като `semantic-release` и генератори на changelog.
Основни функции и възможности
- Пълен каталог от типове: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
- Опционално поле за обхват (scope) и напомняния в реално време за дължината на заглавието и повелителния тон
- Превключвател с едно щракване за Breaking Change, прилагащ стандартния синтаксис с удивителен знак (`!`)
- Генератор за автоматично свързване на задачи в долния колонтитул с копиране на пълната команда `git commit -m` с едно щракване
Как да използвате
- 1
Изберете типа на комита (напр. `feat` за нови функционалности, `fix` за отстраняване на бъгове).
- 2
Въведете опционален обхват (напр. `api`, `auth`) и кратко повелително описание.
- 3
Прегледайте сглобения низ на комита и копирайте пълната команда `git commit` за вашия терминал.
Чести сценарии на употреба
- → Въвеждане на инженерни екипи в единни стандарти за историята на Git комитите
- → Автоматизиране на промените на семантичните версии и генерирането на бележки по версиите (release notes) в CI/CD пайплайни
- → Маркиране на несъвместими с предишни версии промени в API (breaking changes) при големи актуализации на библиотеки
Свързани инструменти
Генератор на HTML мета тагове (SEO)
Генериране на пълни мета тагове за SEO, Open Graph и Twitter Cards.
.gitignore Генератор
Създаване на подходящи .gitignore файлове за Node.js, Python, Java, Go, Rust и десетки други среди.
Генератор на софтуерни лицензи
Генериране на стандартни Open Source лицензи (MIT, Apache 2.0, GPL, BSD) с вашите данни.
Генератор на README файлове
Интерактивно структуриране и генериране на професионален README.md файл за проекти.
Калкулатор за семантично версиониране (SemVer)
Валидация, сравнение и изчисляване на следваща версия съгласно Semantic Versioning.
Преглед на OpenAPI / Swagger документация
Интерактивен рендеринг и тестване на OpenAPI 3.0 и Swagger спецификации.
Често задавани въпроси и поверителност
Каква промяна в семантичната версия съответства на всеки тип комит?
Съгласно стандартните конвенции на Conventional Commits, `fix` предизвиква PATCH повишение, `feat` води до MINOR повишение, а всеки комит с `BREAKING CHANGE` задейства MAJOR повишение.
Трябва ли редът с темата (subject) да завършва с точка?
Не. Добрите практики при Conventional Commits препоръчват кратко повелително изречение без точка накрая (напр. `feat: allow user avatar upload`).