naming · timschoch — скилл для Claude Code: правила имён в коде

Что делает naming

Скилл держит один список правил именования, синхронизированный с хабом. Перед тем как что-то назвать, агент запускает node .agents/skills/naming/scripts/config.mjs и читает вывод как текущие правила: скрипт печатает базовый references/naming.json, слитый с переопределениями проекта. Часть проверок машинная — гейт naming прогоняет их на push и в CI, остальное остаётся на суждение человека.

Внутри двенадцать правил. Слово берётся из GLOSSARY.md, потом из существующих типов, таблиц и роутов: слово репозитория важнее слова из запроса. Нет слова — сначала term-check, потом запись в глоссарий через domain-modeling. Запрещены префиксы I и T, венгерская нотация, сокращения вроде opts и err, одиночные буквы. Имя строится из частей по порядку от крупного к мелкому, действие начинается с глагола из prefixes, событие — факт в прошедшем времени. enum не используется, вместо него строковый union или as const.

Переопределения живут в .skilly/naming.json — та же структура, что у базового файла, только изменённые ключи. Существующее соглашение репозитория сильнее правил скилла, и задаётся оно в artifacts.file.case и artifacts.folder.case. Сменилось значение — переименование идёт везде в одном изменении, вместе с обновлением глоссария, иначе в коде и документации останутся два слова для одной вещи.