Скиллы для AI-агента: работа с игрой целиком [wiki.qeng.org]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
{{indexmenu_n>65}}
====== Скиллы для AI-агента: работа с игрой целиком ======

Страница [[authors_main:task_editor:ai_authoring|про промпт]] — для чат-бота, который пишет задания в чате. Эта — для **агента с доступом к файлам** (Claude Code, Codex, Cursor, Gemini CLI, Grok Build и подобные): он берёт игру, выгруженную из редактора, разбирается в ней и правит её — уровни, коды, бонусы, подсказки, порядок заданий — не читая JSON руками, а через инструмент. Умеет и придумать уровень по справочнику движка с примерами из [[https://qeng.org/game.php?gid=3493|демо-игры]].

Скиллов два:
  * **qeng-game-json** — чтение и правка файла игры: «что на уровне 5», «поменяй автопереход», «переставь уровень 7 на место 3», «что не так в игре».
  * **qeng-game-author** — как писать уровень: справочник по движку, примеры из демо-игры, пошаговые рецепты.

===== Как подключить: быстрый путь =====

Дайте агенту ссылку на эту страницу и попросите поставить скиллы — дальше он сделает всё сам по инструкции в конце страницы: скачает архив, разложит скиллы куда нужно, проверит версию. Нужен только Python 3.9 или новее; если агент скажет, что его нет, поставьте с [[https://www.python.org/downloads/|python.org]].

Дальше: в редакторе «Скачать JSON» — этот файл ''game_N.json'' вы и отдаёте агенту. Назад — импортом в редакторе: «Сохранить...» покажет список изменений и ошибки до записи.

===== Как подключить вручную =====

Архив с обоими скиллами: {{:authors_main:task_editor:qeng-game-skills.zip|qeng-game-skills.zip}}. Внутри две папки, ''qeng-game-json'' и ''qeng-game-author''; положите обе туда, где их ищет ваш агент.

==== Claude Code ====
Папки — в ''.claude/skills/'' проекта (только для него) или в ''~/.claude/skills/'' (для всех проектов). Новый скилл подхватывается при следующем запуске; вызвать явно — ''/qeng-game-json''.

==== Codex, Cursor, Gemini CLI, Grok Build ====
Все четыре читают одно и то же место: ''.agents/skills/'' проекта или ''~/.agents/skills/'' в домашней папке.
  * **Codex** (CLI, расширение для IDE, приложение): вызвать явно — ''$qeng-game-json''.
  * **Cursor** — с версии 2.4; вызвать явно — ''/qeng-game-json'' в чате агента.
  * **Gemini CLI** спросит разрешение, прежде чем включить скилл; список — ''gemini skills list''.
  * **Grok Build** (терминальный агент xAI): кроме ''.agents/skills/'' читает и ''~/.grok/skills/''.

==== claude.ai ====
В claude.ai скилл загружается в настройках, и **каждый своим архивом**: {{:authors_main:task_editor:qeng-game-json.zip|qeng-game-json.zip}} и {{:authors_main:task_editor:qeng-game-author.zip|qeng-game-author.zip}}.
  - Включите выполнение кода: Settings → Capabilities. В Team и Enterprise это и скиллы включает владелец организации.
  - Customize → Skills → «+» → Create skill → Upload a skill — по очереди оба архива.
  - Файл игры прикрепите к сообщению в чате; изменённый Claude отдаст файлом для скачивания.

==== Другие агенты ====
Агент без поддержки скиллов тоже справится, если у него есть доступ к файлам и командной строке: распакуйте архив рядом с игрой и попросите агента прочитать ''qeng-game-json/SKILL.md'' и ''qeng-game-author/SKILL.md'' перед работой. В чат-ботах без выполнения кода (например, в веб-чате Grok) скилл не работает: инструменту нужен Python.

===== Инструкция для агента =====

<code>
You are installing two skills for working with qeng.org games (version 0.1.0):
- qeng-game-json: read and edit a game export - the JSON the game editor downloads - as objects (levels, codes, bonuses, hints, lines), through a Python tool, never by opening the JSON;
- qeng-game-author: how a level is written - the engine's reference by topic, working levels of the demo game as examples, step-by-step recipes.

1. Requirement: Python 3.9 or newer (`python --version` or `python3 --version`). Nothing else: the tool uses only the standard library.
2. Download https://wiki.qeng.org/lib/exe/fetch.php?media=authors_main:task_editor:qeng-game-skills.zip and unpack it. It holds two folders, qeng-game-json/ and qeng-game-author/. Put both where your agent looks for skills:
   - Claude Code: .claude/skills/ of the project, or ~/.claude/skills/ for every project.
   - Codex, Cursor (2.4 or newer), Gemini CLI, Grok Build: .agents/skills/ of the project, or ~/.agents/skills/ for every project - all four read it.
   - Any other agent: anywhere; read qeng-game-json/SKILL.md and qeng-game-author/SKILL.md before working.
   Some agents load new skills only on the next start, or ask the user to approve a skill first (Gemini CLI).
3. Verify: `python qeng-game-json/qeng_game.py --version` (run from the skills folder) prints `qeng_game.py 0.1.0`. If this page names a newer version than the one installed, download again.
4. The game: the author downloads it in the game editor ("Download JSON", a file game_N.json) and gives it to you. Work on that file only with qeng_game.py - start with `python qeng-game-json/qeng_game.py --game game_N.json summary`, then `levels`. When done, the author imports the file back in the editor; "Save..." there lists every change and checks it before writing.
5. Translating a game is not part of these skills: the editor's "Translate" tab does that.

This page as plain text: https://wiki.qeng.org/doku.php?id=authors_main:task_editor:ai_agent&do=export_raw
</code>

<note tip>Перевод игры в скиллы не входит — его делает вкладка «Перевод» редактора; см. [[authors_main:game_management:localization|Локализация игры]].</note>