docs(skills): обновлен шаблон conventional-commits под markdown-список
- Зачем: - привести формат commit body к виду, который используется в репозитории и ожидается в UI. - Что: - заменен плоский шаблон `Зачем/Что/Проверка` на markdown-список с подпунктами. - добавлены явные требования к структуре тела коммита и количеству пунктов. - обновлены примеры и heredoc-шаблон под новый формат. - Проверка: - git log -1 --pretty=format:'%s%n%n%b'. - проверить, что секции выводятся как list в UI.
This commit is contained in:
1 parent
410e543ade
commit
f34e638084
1 file changed
+44
-18
@@ -20,10 +20,20 @@ description: "ОБЯЗАТЕЛЬНО вызывай этот навык кажд
|
|||||||
* Грамматика (Английский): повелительное наклонение (add, fix, update). Без точки в конце.
|
* Грамматика (Английский): повелительное наклонение (add, fix, update). Без точки в конце.
|
||||||
* Технические термины (SQL, DWH, PostgreSQL, Airflow) не переводи.
|
* Технические термины (SQL, DWH, PostgreSQL, Airflow) не переводи.
|
||||||
|
|
||||||
# Шаблон тела коммита (Плоская структура)
|
# Шаблон тела коммита (Markdown-список)
|
||||||
Зачем: [Бизнес-причина или техническая необходимость]
|
- Зачем:
|
||||||
Что: [Ключевые изменения]
|
- [Бизнес-причина или техническая необходимость]
|
||||||
Проверка: [Как проверить: команда, тест или скрипт]
|
- Что:
|
||||||
|
- [Ключевое изменение 1]
|
||||||
|
- [Ключевое изменение 2, если есть]
|
||||||
|
- Проверка:
|
||||||
|
- [Как проверить: команда, тест или скрипт]
|
||||||
|
|
||||||
|
Требования к телу:
|
||||||
|
* Всегда используй именно список с маркерами `-`, как в шаблоне выше.
|
||||||
|
* Обязательные секции: `Зачем`, `Что`, `Проверка`.
|
||||||
|
* Внутри каждой секции минимум 1 подпункт.
|
||||||
|
* В секции `Что` обычно 1-3 подпункта с фактами по diff.
|
||||||
|
|
||||||
# Строгое правило форматирования (Анти-экранирование)
|
# Строгое правило форматирования (Анти-экранирование)
|
||||||
КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНО использовать литералы `\n`, `\r`, `\t` в тексте коммита. Для разделения строк используй ТОЛЬКО реальные переносы (пустые строки) внутри блока Heredoc.
|
КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНО использовать литералы `\n`, `\r`, `\t` в тексте коммита. Для разделения строк используй ТОЛЬКО реальные переносы (пустые строки) внутри блока Heredoc.
|
||||||
@@ -32,8 +42,10 @@ description: "ОБЯЗАТЕЛЬНО вызывай этот навык кажд
|
|||||||
Зачем: текст.\nЧто: текст.
|
Зачем: текст.\nЧто: текст.
|
||||||
|
|
||||||
ПРАВИЛЬНО:
|
ПРАВИЛЬНО:
|
||||||
Зачем: текст.
|
- Зачем:
|
||||||
Что: текст.
|
- текст.
|
||||||
|
- Что:
|
||||||
|
- текст.
|
||||||
|
|
||||||
# Правила выполнения команд
|
# Правила выполнения команд
|
||||||
ЗАПРЕЩЕНО использовать флаги `-m`. РАЗРЕШЕНО использовать только формат передачи через Heredoc:
|
ЗАПРЕЩЕНО использовать флаги `-m`. РАЗРЕШЕНО использовать только формат передачи через Heredoc:
|
||||||
@@ -41,9 +53,12 @@ description: "ОБЯЗАТЕЛЬНО вызывай этот навык кажд
|
|||||||
git commit -F- <<'EOF'
|
git commit -F- <<'EOF'
|
||||||
<type>(<scope>): <описание>
|
<type>(<scope>): <описание>
|
||||||
|
|
||||||
Зачем: <текст>
|
- Зачем:
|
||||||
Что: <текст>
|
- <текст>
|
||||||
Проверка: <текст>
|
- Что:
|
||||||
|
- <текст>
|
||||||
|
- Проверка:
|
||||||
|
- <текст>
|
||||||
EOF
|
EOF
|
||||||
|
|
||||||
# Идеальные примеры
|
# Идеальные примеры
|
||||||
@@ -52,25 +67,36 @@ EOF
|
|||||||
git commit -F- <<'EOF'
|
git commit -F- <<'EOF'
|
||||||
feat(sql): добавлен скрипт валидации данных для DWH слоя
|
feat(sql): добавлен скрипт валидации данных для DWH слоя
|
||||||
|
|
||||||
Зачем: необходима проверка целостности и уникальности перед загрузкой в хранилище.
|
- Зачем:
|
||||||
Что: создан файл 04_validation.sql, добавлены проверки на NULL.
|
- необходима проверка целостности и уникальности перед загрузкой в хранилище.
|
||||||
Проверка: psql -f dwh-modeling/sql/04_validation.sql.
|
- Что:
|
||||||
|
- создан файл 04_validation.sql.
|
||||||
|
- добавлены проверки на NULL.
|
||||||
|
- Проверка:
|
||||||
|
- psql -f dwh-modeling/sql/04_validation.sql.
|
||||||
EOF
|
EOF
|
||||||
|
|
||||||
Пример 2 (Русский, багфикс):
|
Пример 2 (Русский, багфикс):
|
||||||
git commit -F- <<'EOF'
|
git commit -F- <<'EOF'
|
||||||
fix(airflow): увеличен таймаут подключения ClickHouse
|
fix(airflow): увеличен таймаут подключения ClickHouse
|
||||||
|
|
||||||
Зачем: DAG падал с ошибкой таймаута при ночной пакетной загрузке.
|
- Зачем:
|
||||||
Что: параметр conn_timeout изменен с 30 до 120 секунд.
|
- DAG падал с ошибкой таймаута при ночной пакетной загрузке.
|
||||||
Проверка: тестовый запуск таски в Airflow UI.
|
- Что:
|
||||||
|
- параметр conn_timeout изменен с 30 до 120 секунд.
|
||||||
|
- Проверка:
|
||||||
|
- тестовый запуск таски в Airflow UI.
|
||||||
EOF
|
EOF
|
||||||
|
|
||||||
Пример 3 (Английский, lang:en):
|
Пример 3 (Английский, lang:en):
|
||||||
git commit -F- <<'EOF'
|
git commit -F- <<'EOF'
|
||||||
refactor(docker): optimize postgres-bookings image size
|
refactor(docker): optimize postgres-bookings image size
|
||||||
|
|
||||||
Зачем: reduce deployment time and registry storage costs.
|
- Зачем:
|
||||||
Что: switched base image to alpine, removed intermediate build artifacts.
|
- reduce deployment time and registry storage costs.
|
||||||
Проверка: docker build and check image size.
|
- Что:
|
||||||
|
- switched base image to alpine.
|
||||||
|
- removed intermediate build artifacts.
|
||||||
|
- Проверка:
|
||||||
|
- docker build and check image size.
|
||||||
EOF
|
EOF
|
||||||
Reference in new issue
Block a user