Установка скиллов и плагинов OpenClaw осуществляется на ваш страх и риск. Все файлы были получены из открытых источников и предоставляются «как есть». Мы не гарантируем их корректную работу, безопасность или совместимость с вашей системой. Перед установкой настоятельно рекомендуется ознакомиться с содержимым кода и убедиться, что вы понимаете, какие изменения будут внесены в вашу систему.
❌ fix: bug (слишком размыто)
✅ fix: resolve null pointer exception in user service
❌ feat: add feature (избыточно)
✅ feat: add user profile page
Следование этим правилам делает историю коммитов понятной как для людей, так и для инструментов автоматизации. :
Файл из источника
❌ Added new feature (прошедшее время, заглавные буквы)
✅ feat: add new feature
❌ fix: bug (слишком размыто)
✅ fix: resolve null pointer exception in user service
❌ feat: add feature (избыточно)
✅ feat: add user profile page
Следование этим правилам делает историю коммитов понятной как для людей, так и для инструментов автоматизации. :
Файл из источника
Форматируйте сообщения коммитов в соответствии со спецификацией Conventional Commits. Это позволяет автоматически генерировать changelog, использовать семантическое версионирование и поддерживать чистую и понятную историю изменений.
Типы коммитов
Обязательные типы:
- feat: новая функциональность (соответствует MINOR в SemVer)
- fix: исправление ошибки (соответствует PATCH в SemVer)
Дополнительные распространённые типы:
- docs: изменения только в документации
- style: изменения форматирования (без изменения логики)
- refactor: рефакторинг без исправлений и новых функций
- perf: улучшения производительности
- test: добавление или обновление тестов
- build: изменения системы сборки или зависимостей
- ci: изменения конфигурации CI/CD
- chore: прочие изменения вне src и test
- revert: откат предыдущего коммита
Scope (область изменений)
Scope — необязательная часть, которая добавляет контекст и указывает, к какой части проекта относится изменение:
feat(parser): add ability to parse arrays
fix(auth): resolve token expiration issue
docs(readme): update installation instructionsРекомендации
- Всегда используйте тип — каждый коммит должен начинаться с него
- Пишите в повелительном наклонении (как будто завершаете фразу «Этот коммит…»)
- Будьте конкретны — описание должно ясно отражать изменения
- Один коммит — одно логическое изменение
- Используйте scope при необходимости для уточнения
- Отмечайте breaking changes явно
Связь с семантическим версионированием
- fix: увеличивает PATCH (например, 1.0.0 → 1.0.1)
- feat: увеличивает MINOR (например, 1.0.0 → 1.1.0)
- BREAKING CHANGE: увеличивает MAJOR (например, 1.0.0 → 2.0.0)
Когда использовать
- Во всех git-коммитах
- При генерации сообщений коммитов
- При merge pull request
- Когда требуется стандартизировать историю изменений
Частые ошибки
❌ Added new feature (прошедшее время, заглавные буквы)
✅ feat: add new feature
❌ fix: bug (слишком размыто)
✅ fix: resolve null pointer exception in user service
❌ feat: add feature (избыточно)
✅ feat: add user profile page
Следование этим правилам делает историю коммитов понятной как для людей, так и для инструментов автоматизации. :
Файл из источника