SayGames · плагин для Claude Code · версия 0.1
Скиллы для AI‑креатора игры
Пять наборов правил, которые Клод читает сам и закрывает типовые вопросы прототипа: от первого экрана до билда, готового к тесту. Ставится один раз, дальше работаешь как обычно.
Зачем
Кристина поиграла в несколько проектов и собрала список. Вера, Андрей, Паша дополнили. Эти замечания повторяются от проекта к проекту, и каждый раз продюсеры объясняют их заново. Клод без контекста делает одни и те же «разумные» вещи, которые в мобильных играх не работают. Studio Skills записывает опыт студии один раз, чтобы каждый AI‑креатор начинал с него, а не с нуля.
Логотип, «Tap to play», лобби. Каждый лишний тап до игры — лишние отвалы.
Статистика, звёзды, «переиграть», три кнопки. Нужен подарок и одна кнопка «дальше».
Два бустера за уровень, текстовые карточки, обучение, на котором можно проиграть.
Межстраничная после 3-го уровня, на тапе «дальше», внутри обучения.
События не отправляются, числа зашиты в код, сложность не поправить без перезаливки.
30 кадров в секунду, дебаг-меню в релизе, нагрев, потеря прогресса при сворачивании.
Что внутри
Скилл — это папка с инструкциями и правилами, которую Клод читает сам, когда понимает, что задача про игру. Выбери скилл, чтобы увидеть, на какие слова он отзывается и что отдаёт.
Как работает
«Почти» не считается. Нажми на стадию, чтобы увидеть, что на ней делается и какие условия должны быть выполнены.
Расписание обучения, уровень первой рекламы, цены ревайва, зоны тапа, бюджеты кадров — всё с числами. Применяет и записывает в docs/open-questions.md: правило, значение, откуда, как поменять.
Только пять вопросов на старте. Решение AI‑креатора сильнее любого правила: если дизайн-документ говорит иначе, Клод делает по документу и помечает переопределение.
У каждого числа пометка: проверено на проектах, предложение, из кода, решение AI‑креатора. Где правила нет — говорит одной строкой, берёт осторожный вариант, ставит вопрос в список.
Примеры
Тестовый прогон 5 ноября: AI‑креатор пишет «делаем сортировку шариков по пробиркам, на следующей неделе тест». Переключай, чтобы увидеть, что Клод предложил без скилла и со скиллом.
Таблица ниже показывает обе колонки сразу; переключатель подсвечивает выбранную.
| Место | Без скилла | Со скиллом |
|---|---|---|
| Первый экран | Логотип → «Tap to play» → лобби → уровень | Сразу уровень 1, согласия после первой победы |
| Обучение | Текстовая карточка с правилами, два бустера на уровне | Рука показывает ход, одна новинка на уровень, 2–3 уровня практики |
| Винскрин | Статистика ходов, звёзды, «переиграть», магазин | Награда и одна кнопка «дальше»; ×2 за рекламу только когда валюта нужна |
| Проигрыш | «Вы проиграли» без причины, одно продолжение | Причина на экране, лестница цен, первое продолжение бесплатно или за рекламу |
| Реклама | Уровень 3–4, на тапе «дальше» | Ключ ремоута, по умолчанию 8-й уровень, на переходе после победы |
| Настройки | Числа зашиты в код | Каждое число — ключ с диапазоном; порядок уровней правится без перезаливки |
| Релиз | Дебаг-меню и читы в сторе, 30 кадров в секунду | Дев-контент вырезан сборкой, 60 кадров, скрипт-проверка перед отдачей |
Пример на существующем проекте
Прототип на Unity на середине пути, idle без проигрыша. Без скилла Клод отвечает «в целом всё хорошо». Со скиллами он прошёл 18 строк готовности (16 не выполнены) и нашёл по коду, с указанием файла и строки:
Частота кадров не задана, Unity на Android по умолчанию даёт 30.
ProjectSettings.asset:72Прогресс сохраняется только после тапа «Дальше»; закрыл игру на окне победы — играй заново.
LevelCompleteState.cs:51Тап по кнопке без денег ничего не делает: обработчик пустой.
RuntimeFeedbackAdapter.cs:93Незакоммиченная правка сузила поле, главное число обрезано многоточием.
Hud/BottomPanel.prefabМеню разработчика и SRDebugger ничем не вырезаются из сборки для стора.
SayDynamicDebugMenu.asmdefНет ни проигрыша, ни застоя: рекламе за награду негде встать. Скилл предложил вариант и пометил его как предложение.
docs/open-questions.mdАудит ничего не меняет в проекте без согласия владельца: черновики документов кладутся рядом с отчётом.
Установка
/plugin install saygames-studio --marketplace git@gitlab.saygames.io:teams/saystudio/saygames-studio-skills.gitНужен SSH-доступ к GitLab. После установки перезапусти сессию: плагины читаются при старте.
Установи плагин Claude Code saygames-studio из маркетплейса git@gitlab.saygames.io:teams/saystudio/saygames-studio-skills.git и напомни перезапустить сессиюКлод склонирует репозиторий и выполнит команду сам. В README репозитория это сообщение лежит готовым.
После новых правил в репозитории: /plugin marketplace update saygames-studio, затем /plugin update saygames-studio. Без плагина можно скопировать папки из skills/ в ~/.claude/skills/.
Если скилл не подхватился сам, его можно назвать прямо: «используй saygames-studio-game-design».
| Скилл | Что сказать Клоду | Что получишь |
|---|---|---|
| game-creator | «Делаем игру про…», «что ещё нужно до теста», «готов ли билд к тесту» | Стадию, пять вопросов, список готовности из 18 строк |
| game-design | «Сделай обучение на первых уровнях», «посмотри фидбек с плейтеста», «где ставить рекламу» | Расписание уровней, экраны результата, лестницу ревайва, места рекламы |
| game-ui | «Проверь UI», «сделай стиль окон», «аудит скриншотов» | Токены стиля, спеки экранов, аудит с найденными проблемами |
| game-analytics | «Что логировать», «что вынести в ремоут», «что крутить в тесте» | Спеку событий, файл настроек с диапазонами, проверку на устройстве |
| game-tech | «Тормозит», «собери релизный билд», «стор отклонил» | Бюджеты, чеклист релиза, найденный дев-контент и утечки |
Честно о границах
Скилл — это записанный опыт, а не истина. Вот случаи, где он ошибается или мешает, и что с этим делать прямо в работе.
Правила выросли из головоломок с уровнями по минуте. Для idle, merge, слов и аркад с таймером часть значений — предложения, помеченные [proposed]. Если правило не ложится на игру, Клод обязан написать «не применимо по жанру» и назвать замену; если он этого не сделал, скажи ему.
На ранних стадиях список готовности почти весь красный, и это нормально. Красная строка — не запрет работать дальше, а список того, что осталось. Спорить стоит с конкретной строкой, а не с чеклистом целиком.
Клод может «починить» то, что ты сделал специально: убрать кнопку, перенести рекламу. Запиши решение в дизайн-документ или скажи в чате — оно сильнее правила и попадёт в открытые вопросы как переопределение. Так скилл узнаёт, где он не прав.
Скилл включается по словам запроса. Если ответ выглядит как обычный, без стадии и чеклиста, назови скилл прямо: «используй saygames-studio-game-design». В длинном чате Клод может забыть правило из начала — попроси перечитать скилл.
Проверка сборки и разбор префабов работают по шаблонам: бывают ложные срабатывания и пропуски. Их вывод — повод посмотреть, а не вердикт. Нашёл ложное срабатывание — это тоже идея для таблицы.
Требования бота, Launcher и DevOps меняются быстрее, чем скилл. Если бот требует то, чего скилл не знает, прав бот; напиши об этом в «Идеи», чтобы скилл догнал.
Как улучшать вместе
Каждое правило, которое попало в Studio Skills, перестаёт быть устным знанием одного продюсера и начинает работать на все прототипы сразу. Поэтому главный вклад — не код, а замечание в правильном месте.
Любой пишет своими словами, что сработало или мешало, и подписывается. Без формата. Плохой результат скилла — такая же идея, как хороший приём.
Мы превращаем идею в правило: что делать, значение по умолчанию, почему, исключения, автор.
Правило попадает в скилл и проверяется на реальном проекте: один и тот же запрос без скилла и со скиллом. Спорные правила лежат в таблице со статусом «спорно», пока команда не договорится.
Фидбек продюсера по твоему билду и что он дал. Решение, которое ты бы перенёс в следующий проект. Место, где скилл спорил с тобой и был не прав. Ложное срабатывание скрипта. Цифры из теста, которые подтверждают или опровергают значение по умолчанию.
Около 240 правил на пяти листах простым языком, с авторством, и глоссарий. Фидбек из канала #sg-studio-rnd-team уже разобран: Паша, Вера, Андрей, Кристина, Вика, Юра — авторы 16 правил. Умеет: головоломки с короткими уровнями, idle без проигрыша, аудит проекта на Unity и HTML, слой SayGames.
Жанровых пакетов (merge, слова, аркады с таймером); часть чисел ждёт подтверждения тестом; пять открытых вопросов DevOps; правил для меты и live-ops. Это версия 0.1: обновления выходят по мере того, как таблица пополняется, одной командой в Claude Code.
Поставить плагин, сделать на нём следующий прототип и написать на лист «Идеи», что было не так. Один разобранный фидбек экономит час каждому следующему AI‑креатору: скилл становится лучше ровно настолько, насколько студия делится тем, что сработало и что нет.