av-dev-git: добавлен плагин со скиллом commit

- скилл commit кодирует личный стиль сообщений: русский, опциональный scope-префикс, первая строка «что сделано», тело 1–3 пункта, без co-authored - плагин добавлен в marketplace.json и в секцию README
2026-07-24 09:31:08 +03:00
parent cd1d358326
commit 675061739a
4 changed files with 67 additions and 0 deletions
@@ -0,0 +1,49 @@
+---
+name: commit
+description: Оформить git-коммит в личном стиле проекта. Сообщение на русском, средняя детализация, опциональный scope-префикс, первая строка отвечает «что сделано», тело — списком 1–3 пункта, без co-authored. Использовать, когда нужно закоммитить изменения или сформулировать текст коммита.
+---
+
+# Коммит
+
+Сообщение коммита на русском, лаконичное, но не пустое. Цель формулировки —
+чтобы через полгода можно было быстро найти изменение по области или по проблеме.
+Уровень конкретики средний: не абстрактно («правки», «фиксы»), но и не пересказ
+диффа построчно — достаточно, чтобы понять суть.
+
+## Первая строка
+
+- Отвечает на вопрос **что сделано** — результатом, а не командой: `добавлены`,
+  `изменён`, `обновлено`, `исправлен`, `удалено`, `переименовано` и т.п.
+- В начале **опционально** область изменения через двоеточие: `<scope>: <текст>`.
+  Scope — пакет, файл или подсистема (`backlog:`, `readme.md`). Если область
+  очевидна или изменение размазано — можно без неё.
+- Английские термины, имена классов, функций, файлов — оставляем на английском,
+  не транслитерируем и не переводим.
+
+## Тело (опционально)
+
+- Нужно, только когда первой строки мало: неочевидное «почему», важная деталь,
+  несколько разнородных изменений.
+- Списком, **1–3 пункта**. Не влезает в три — сигнал, что коммит стоит разбить.
+- Та же средняя детализация, что и в заголовке.
+
+## Чего НЕ делаем
+
+- **Без `Co-Authored-By`** и любых трейлеров-подписей.
+- Не пишем прозу по-английски (кроме терминов и имён).
+- Не уходим в крайности — ни абстракция, ни построчный отчёт.
+
+## Примеры
+
+```
+backlog: добавлены задачи про загрузку
+```
+```
+readme.md дополнен информацией об установке плагинов
+```
+```
+исправлен баг с отображением источника
+```
+
+Разнородные изменения — не один коммит с длинным телом, а несколько коммитов,
+каждый со своей узкой первой строкой.