Dandy Code Skills: как заставить AI писать код аккуратнее

AI-агенты уже умеют писать код.

Но есть проблема: они часто пишут слишком бодро, без оглядки на правила и стандарты.

Попросил поправить один метод — получил новый сервис, DTO, Factory, интерфейс, абстрактный класс и ощущение, что проект тихо превратился в строительную площадку.

Чтобы такого было меньше, я собрал Dandy Code Skills.

Это набор skills для AI-агентов, которые помогают писать и проверять PHP/Laravel-код аккуратнее.

Идея взята из книги «Денди-код».

Книга: https://github.com/tabuna/dandy-code
Репозиторий: https://github.com/tikhomirov/dandy-code-skills

Что это такое

Dandy Code Skills — это готовые инструкции для AI-агентов.

Они подходят для:

Claude Code;
OpenCode;
Pi;
других codex-style агентов.

Обычно агенту надо долго объяснять:

Пиши аккуратно, не ломай бизнес-логику, не делай лишних классов, проверь имена, убери вложенность, не забывай про Laravel-way.

Это надоедает.

Skills решают эту проблему.

Ты один раз подключаешь правила, а потом можешь писать проще:

Проверь проект в денди-стиле.

И агент уже понимает, что нужно смотреть не только на “работает / не работает”, но и на читаемость кода.

Что умеют Dandy Code Skills

В репозитории есть 4 основных skill:

dandy-style — общий денди-стиль;
dandy-review — ревью проекта, файла или модуля;
dandy-commit — проверка кода перед коммитом;
dandy-breakdown — разбор конкретного метода или класса.

Внутри есть правила по мотивам книги:

как должен выглядеть README;
как держать единый стиль кода;
как делать код визуально чище;
как выбирать нормальные имена;
как убирать магические числа и строки;
как уменьшать вложенность;
как упрощать условия;
как чистить бесполезные комментарии;
как проверять код, который написал AI;
как не забывать про Laravel-way.

То есть это не “сделай красиво”.

Это конкретный список: куда смотреть, что считать проблемой и где лучше не трогать код без причины.

Зачем это нужно

AI часто пишет код, который вроде работает.

Но потом открываешь файл и думаешь:

Кто это написал? И почему он так уверен в себе?

Типичные проблемы:

плохие имена переменных;
слишком длинные методы;
много вложенных if;
магические значения вроде 1, status, paid;
комментарии, которые просто пересказывают код;
лишние классы “на всякий случай”;
Laravel-код, который написан как будто Laravel рядом не стоял.

Dandy Code Skills помогают агенту замечать такие вещи.

Он начинает отвечать полезнее:

тут имя непонятное;
тут лучше сделать ранний выход;
тут условие слишком сложное;
тут комментарий лишний;
тут магическое значение лучше заменить на enum или константу;
а вот это лучше не трогать, потому что можно сломать бизнес-логику.

Это особенно полезно перед коммитом.

AI написал код — хорошо. Но перед тем как отправить это в репозиторий, лучше дать ему самому же проверить результат. Пусть хотя бы за собой посуду помоет.

Как установить

Самый простой способ:

npx github:tikhomirov/dandy-code-skills install

Установщик спросит:

ставить в текущий проект или глобально;
какую директорию использовать;
для какого агента ставить skills;
удалять ли старые версии Dandy-skills.

Глобальная установка:

npx github:tikhomirov/dandy-code-skills install --global

Установка без вопросов:

npx github:tikhomirov/dandy-code-skills install --yes

Посмотреть, что будет установлено:

npx github:tikhomirov/dandy-code-skills install --dry-run

Установщик аккуратный: он удаляет только старые Dandy-skills. Ваши личные skills трогать не должен.

Как пользоваться

Для ревью проекта:

/dandy-review

Для проверки перед коммитом:

/dandy-commit

Для разбора конкретного метода:

/dandy-breakdown

Можно писать и обычным языком:

Проверь проект в денди-стиле.
Отрефактори модуль оплаты по правилам Денди-кода.
Проверь diff перед коммитом, как денди.
Разбери метод, он должен быть как денди.

Агент сам выберет нужные правила.

Ему не надо каждый раз читать всё подряд. Он смотрит карту рецептов и берёт только то, что нужно для задачи.

Это экономит токены и снижает шанс, что маленькая правка превратится в большой архитектурный праздник.

Где посмотреть

Репозиторий со skills:

https://github.com/tikhomirov/dandy-code-skills

Книга «Денди-код»:

https://github.com/tabuna/dandy-code

Если вы используете AI-агентов для PHP/Laravel-разработки, попробуйте начать с простой команды:

/dandy-review

Одна команда — и агент уже смотрит на код не как генератор текста, а как человек, которому потом этот код читать.

Без лишней архитектуры.

Без миллиона токенов.

Без “я немного улучшил метод и случайно впихнул в него еще десять”.

Dandy Code Skills: простой способ улучшить код с AI

Минималистичные skills для AI-агентов, которые одной командой помогают увидеть слабые места PHP/Laravel-кода.