evolutionary-naming

Скилл Claude Code для эволюционного именования — постепенного улучшения имён через прогрессивное уточнение вместо попытки найти идеальное имя за один шаг.

Именование — это процесс, а не единственный шаг. Скилл проводит имена через 7 последовательных шагов, сгруппированных в 3 фазы, фиксируя каждый шаг коммитом, чтобы улучшения были безопасными, инкрементальными и обратимыми.

Что делает скилл

Фаза	Шаги	Характер
Фаза 1: От идеи к имени	Отсутствует → Бессмысленное → Честное → Честное и полное	Универсальный. Чистое именование. Безопасно.
Фаза 2: От имени к структуре	Честное и полное → Делает правильное	Структурный рефакторинг. Запрашивает разрешение.
Фаза 3: Объединение для дизайна	Делает правильное → Намерение → Доменная абстракция	Уровень домена. Запрашивает разрешение.

Скилл работает в двух режимах:

audit-mode — исчерпывающее сканирование предоставленного кода, классифицирует каждый идентификатор по текущему шагу, выводит структурированную таблицу, сгруппированную по фазам. Не переименовывает.
improve-mode — интерактивное улучшение одной цели. Непрерывно проходит Фазу 1, делает паузу перед Фазой 2 и Фазой 3.

Глубина работы должна соответствовать реальной задаче пользователя. Большинство улучшений именования следует останавливать после Фазы 1.

Установка

Через маркетплейс (рекомендуется)

/plugin marketplace add kawasima/evolutionary-naming
/plugin install evolutionary-naming@kawasima-skills

Через skills.sh

npx skills add kawasima/evolutionary-naming

Ручная установка (для одного пользователя)

bash

git clone https://github.com/kawasima/evolutionary-naming.git
cp -r evolutionary-naming/skills/evolutionary-naming ~/.claude/skills/

Claude Code автоматически обнаруживает скиллы из ~/.claude/skills/. Настройка не требуется.

Использование

Скилл активируется автоматически, когда вы просите Claude улучшить именование, отрефакторить класс/метод или проверить качество имён.

Триггеры audit-mode:

"このコードの命名で改善余地ある?"
"命名レビューして"
"naming audit"

Триггеры improve-mode:

"d を改善して"
"DocumentManager をリファクタリング"
"this method's name is unclear"

Если запрос неоднозначен (большой фрагмент кода без конкретной цели), скилл уточняет, какой режим использовать.

Файлы

skills/evolutionary-naming/
├── SKILL.md          router and overview
├── reference.md      shared 7-step diagnosis, transitions, red flags
├── audit-mode.md     exhaustive scan workflow + table output
└── improve-mode.md   interactive single-target + pause protocol

Лицензия

CC BY 4.0. См. LICENSE.

История и благодарности

Модель из 7 шагов и 3 фаз, используемая в этом скилле, основана на серии статей Arlo Belshee «Naming as a Process» (CC BY 3.0) — одном из наиболее детальных публичных материалов по эволюционному именованию. Скилл адаптирует этот материал в формат скиллов Claude Code с режимами audit/improve и защитными барьерами на границах фаз.

Источники:

Оригинальная серия статей: https://arlobelshee.com/tag/naming-is-a-process
Обновлённое издание: https://www.digdeeproots.com/articles/naming-process/

Другие материалы, заслуживающие внимания:

Каталоги рефакторинга (extract method, rename, introduce parameter object) — Martin Fowler
Domain-Driven Design (Whole Value, Ubiquitous Language) — Eric Evans

Эволюционное именование

Установка

README

evolutionary-naming

Что делает скилл

Установка

Через маркетплейс (рекомендуется)

Через skills.sh

Ручная установка (для одного пользователя)

Использование

Файлы

Лицензия

История и благодарности