commit-helper — скилл для Claude Code: что делает и как установить
Помогает оформлять коммиты и пулреквесты по стандартам CockroachDB. Анализирует git diff, формирует структуру сообщения и добавляет заметки к релизу.
npx skills add cockroachdb/cockroach --skill commit-helper -a claude-codeЧто делает commit-helper
Скилл автоматизирует подготовку коммитов перед отправкой в репозиторий. Сначала он изучает изменения через git diff или git diff --staged и определяет префикс затронутого пакета. Затем агент запрашивает номер задачи или эпика. Также он выясняет, нужна ли запись в список изменений.
Заголовок составляется в повелительном наклонении без точки на конце и строго до 72 символов. Тело коммита раскрывает причины правок. Внизу добавляются ссылки вида Resolves: #123 или Epic: CRDB-357. Строка Release note обязательна для каждого коммита: если внешних изменений нет, указывается None, а для видимых пользователю правок выбирается точная категория вроде bug fix или sql change.
Без точной категории релизной заметки правила репозитория не пропустят коммит. Скилл также учитывает правила оформления пуллреквестов: для единственного коммита дублирует текст в описание PR, а для цепочки правок составляет общее резюме изменений.
Какие задачи решает
- составить сообщение коммита по гайдлайнам CockroachDB
- разметить заметки к релизу с нужной категорией
- связать коммит с номерами issue и epic
- оформить описание единичного или составного пулреквеста
Примеры запросов агенту
- Сделай коммит для текущих изменений и добавь заметку к релизу
- Оформи коммит по правилам CockroachDB для задачи #123
- Подготовь описание пулреквеста на основе последних коммитов
Как установить commit-helper
1Через Skills CLI (Vercel)
npx skills add cockroachdb/cockroach --skill commit-helper -a claude-code2Вручную: положить файлы
~/.claude/skills/commit-helper/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/commit-helper/
1Через Skills CLI (Vercel)
npx skills add cockroachdb/cockroach --skill commit-helper -a codex2Вручную: положить файлы
.agents/skills/commit-helper/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cockroachdb/cockroach --skill commit-helper -a cursor2Вручную: положить файлы
.cursor/skills/commit-helper/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cockroachdb/cockroach commit-helper2Вручную: положить файлы
.github/skills/commit-helper/SKILL.md1Через Skills CLI (Vercel)
npx skills add cockroachdb/cockroach --skill commit-helper -a gemini-cli2Командой платформы
gemini skills install https://github.com/cockroachdb/cockroach --path .claude/skills/commit-helperВручную: положить файлы
.devin/skills/commit-helper/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cockroachdb/cockroach --skill commit-helper -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о commit-helper
Как установить commit-helper в Claude Code?
Выполните команду npx skills add cockroachdb/cockroach --skill commit-helper -a claude-code. Конфигурация сохранится в файле ~/.claude/skills/commit-helper/SKILL.md.
Что делает commit-helper?
Он изучает диффы через Git, находит затронутый пакет и пишет структурированное сообщение коммита. Скилл следит за ограничениями по длине строк, требует ссылки на задачи и добавляет блок заметок к релизу.
Когда для коммита не нужна подробная заметка к релизу?
Если изменения затрагивают только внутренний рефакторинг, тесты или скрытые настройки crdb_internal., в блоке заметок пишется Release note: None. Для любых пользовательских изменений скилл подбирает категорию из фиксированного списка репозитория.
