Пользовательские навыки

Превратите повторяющуюся рутину в собственный инструмент. Пользовательский навык работает так же, как встроенный. Любой агент на вашем компьютере может найти его, загрузить и вызвать в вашем приложении.

Обзор

Каждый коннектор предоставляет свои инструменты в виде навыков, таких как scene, import и materials. Вы можете добавить собственные рядом с ними, например отчёт о сцене, собственное правило для импорта или пакетное переименование. Навык — это папка из трёх частей:

SKILL.md, который описывает его.
tools.yaml, который перечисляет его инструменты.
Скрипты, которые выполняются внутри приложения.

Пользовательские навыки работают в Blender. Страница Skills окна Meshy DCC Core показывает все навыки, их происхождение и то, какое открытое приложение их загрузило.

Страница Skills окна Meshy DCC Core с навыками, загруженными каждым подключённым экземпляром Godot и Blender, включая пользовательский навык my-scene-report

Попросите своего агента написать его

Навык Meshy DCC включает руководство по написанию навыков, поэтому ваш агент может написать его за вас. Опишите рутину, например:

Напиши мне навык для Blender, который подсчитывает объекты в открытой сцене по типу.
Добавь в мой навык scene-report инструмент, который перечисляет меши с более чем 50 000 полигонов.

Агент записывает файлы в вашу папку skills, проверяет их, перезагружает открытые приложения и пробует новый инструмент. Чтобы скопировать готовый prompt, перейдите в раздел My skills на странице Skills.

Раздел My skills страницы Skills с пользовательским навыком my-scene-report, отмеченным как In use в папке по умолчанию Blender, пустой папкой по умолчанию Godot и prompt для того, чтобы ваш агент написал его

Ваша папка skills

В следующей таблице показана папка, которую читает каждое приложение.

Приложение	Папка
Blender	`~/.meshy-dcc/blender/skills/`

Называйте каждую папку навыка строчными словами, соединёнными дефисами, и начинайте её с my- или префикса вашей студии, например my-scene-report. Не используйте повторно имя встроенного навыка. Если вы это сделаете, Meshy DCC Core будет использовать встроенный навык и игнорировать вашу копию.

Чтобы проверить навык перед его загрузкой, выполните:

meshy-dcc lint ~/.meshy-dcc/blender/skills/my-scene-report

Загрузка нового навыка

Открытые приложения подхватывают новые и изменённые навыки при перезагрузке. Чтобы перезагрузить их, перейдите на страницу Skills и нажмите Reload in open apps. Каждый навык отображает одно из следующих состояний:

In use: загружен и готов в открытых приложениях.
Waiting for reload: находится на диске, но ещё не загружен. Если навык остаётся в этом состоянии после перезагрузки, в нём есть ошибка. Чтобы увидеть ошибку, выполните meshy-dcc lint для его папки.
Same name as a built-in skill; rename it: побеждает встроенный навык. Дайте своему другое имя.
App not open: приложение, которому он принадлежит, не запущено.

Уже загруженные навыки остаются загруженными при перезагрузках, а изменённый навык перезагружается самостоятельно.

Обмен навыками с командой

Чтобы поделиться навыками со своей командой, храните их в общей папке. На странице Skills введите полный путь к папке и нажмите Add folder. Открытые приложения сразу же перезагружают её, и её навыки становятся доступны каждому агенту на этом компьютере.