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

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

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

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

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

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

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

# Если имя ещё не известно:
python3 .claude/skills/xbsl-explore/scripts/explore.py --type {Тип} --root {root}
```

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

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

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

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

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

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