name: xbsl-explore description: Разведка структуры проекта 1С:Элемент. Используй этот скилл перед созданием любого объекта конфигурации — находит проекты, подсистемы, существующие объекты, проверяет конфликты имён. Принимает тип объекта и опциональное имя. compatibility: Requires Python 3. metadata: version: "1.0.0"

Во всех командах ниже {python} означает python в Windows и python3 в macOS/Linux/WSL. Выбирай команду сразу по текущей ОС, не запускай оба варианта.

Разведка проекта 1С:Элемент

Шаг 1: Найди папку с проектами и запусти скрипт

Перед запуском найди папку, в которой лежат проекты 1С:Элемент (папки с Проект.yaml):

find . -name "Проект.yaml" -not -path "*/.claude/*" | head -5

Используй родительскую папку найденных проектов как {root}.

# Если имя объекта известно — проверяет конфликт:
{python} skills/xbsl-explore/scripts/explore.py --type {Тип} --name {Имя} --root {root}
 
# Если имя ещё не известно:
{python} skills/xbsl-explore/scripts/explore.py --type {Тип} --root {root}

Где {Тип} — Перечисление, Справочник, Документ и т.д.

Шаг 2: Интерпретируй результат

Из JSON-ответа возьми:

• suggested_path — рекомендуемый путь для создания файла
• conflict — если не null, объект с таким именем уже существует → сообщи пользователю, уточни намерение (обновить или отменить)
• projects[].subsystems[].objects — список существующих объектов нужного типа (полезно для ссылочных полей и контекста)

Шаг 3: Передай результат обратно

Верни suggested_path и conflict вызывающему скиллу для использования в последующих шагах.