Conventional Commit Message — скилл для агентов

Установка

Работает в

• Claude Code
• Codex
• Cursor
• Gemini CLI
• GitHub Copilot
• Windsurf
• Cline
• Roo Code
• Goose
• OpenCode
• Amp
• Koda
• Coddy

npx skillfoxx add skills/conventional-commit-message

Что делает

Скилл conventional-commit-message лежит в папке skills репозитория conventional-changelog, где живут инструменты для выпуска версий и журнала изменений. Когда вы просите агента написать, исправить или проверить сообщение коммита, он сначала смотрит состав изменений: `git diff --staged --name-only`, затем `git diff --name-only` и ищет файлы настроек commitlint и `package.json`. Если в проекте настроен commitlint, агент читает его конфигурацию, чтобы узнать допустимые типы, области, регистр и длину. Тип выбирается по влиянию на релиз, путь к файлу его не определяет. Новое поведение для пользователей получает `feat` и повышает минорную версию, исправление получает `fix` или `perf`, а `docs`, `refactor`, `test`, `build`, `ci` и `chore` скрыты из журнала изменений и версию не повышают. Скилл отдельно предупреждает: правка метаданных или настроек, из-за которой поднимается минимальная версия Node.js, убираются экспорты или ужесточаются зависимости, считается видимой и требует `!` с подписью `BREAKING CHANGE`. В монорепозитории областью служит имя пакета, при общей причине допустимо несколько областей через запятую. Готовое сообщение скилл проверяет локальным `./node_modules/.bin/commitlint`, подавая текст через `echo` или `printf`. Если команда не проходит, агент правит тип, область, регистр или длину и повторяет. Пользователю по умолчанию возвращается только само сообщение, а при сомнении по поводу релиза два варианта с пояснением последствий.

Для кого. Для разработчиков и сопровождающих проектов, которые ведут журнал изменений и версии по Conventional Commits и хотят получать от агента сообщения коммитов без правки формата.

Пример запроса к агенту

Посмотри, что у меня в индексе, и напиши сообщение коммита по Conventional Commits, проверь его через commitlint

Ограничения

• Скилл ориентирован на проекты с пресетом `conventional-changelog-conventionalcommits` и совместимыми инструментами выпуска версий. В остальных репозиториях набор скрытых и видимых типов может не совпасть с правилами команды.
• Для проверки нужен локальный commitlint. Если его нет в `node_modules`, скилл допускает запуск через `pnpm`, `npm exec` или `npx`, но только когда это разрешено в вашем окружении, а если запустить нельзя, агент сообщает об этом.
• Скилл запрашивает у git и файловой системы данные о ваших правках, в том числе список изменяемых файлов, чтобы выбрать область. Содержимое индекса агент видит так же, как при обычной работе в проекте.
• Сам скилл только задает правила и ничего не коммитит: сделать коммит или пересоздать сообщение решает пользователь или агент по вашей просьбе.
• В репозитории пока один скилл, и он касается только сообщений коммитов. Генерации журнала изменений и подъема версий в нем нет.
• Репозиторий распространяется под лицензией ISC, а в шапке самого скилла указана MIT.

Как отключить. Удалите папку conventional-commit-message из каталога скиллов агента (например, из `.claude/skills` проекта или домашней папки). Больше скилл ничего в проекте не меняет: конфигурация commitlint и история коммитов остаются прежними.

Коротко о README

Главная страница репозитория начинается с описания проекта как генератора журнала изменений по данным git и рекомендует три внешних инструмента для автоматизации версий и выпуска. Раздел о скиллах называет один скилл и дает две команды установки, для pnpm и npm. Дальше идут перечень ключевых модулей экосистемы, включая commitlint и commitizen, и таблица всех пакетов репозитория. Отдельная страница сайта проекта объясняет, что скилл делает и что устанавливается в папку скиллов агента.