---
name: 1c-platform-tools
description: Операции с платформой 1С в этом проекте — командами расширения 1C: Platform tools. Используй, когда пользователь просит загрузить/выгрузить конфигурацию, запустить Конфигуратор или Предприятие, установить зависимости, выполнить любую операцию с платформой 1С. Выполняй команды сам (Execute Command / MCP), не запускай внешние скрипты.
---

# Команды 1C: Platform tools для агента

**Если пользователь называет команду или MCP-инструмент по имени** (например «через run_designer», «вызови 1c-platform-tools.run.designer») — сразу вызови именно её, передай projectPath. Не заходи сначала в скилл и не перебирай все инструменты; таблицы ниже — когда задача сформулирована без имени команды.

Выполняй операции 1С через команды расширения. **Ты должен сам выполнять команду**, а не просить пользователя: при запросе «Запусти Конфигуратор» — вызови `1c-platform-tools.run.designer`, при «Запусти Предприятие» — `1c-platform-tools.run.enterprise` и т.д. по таблице ниже. Используй инструмент выполнения команд редактора (Execute Command / runCommand / выполнить команду VS Code). **Не пиши пользователю «из чата вызвать нельзя» или «нажмите Ctrl+Shift+P»** — выполни команду сам. Только если в твоём наборе инструментов нет выполнения команд — тогда предложи пользователю палитру или панель «Инструменты 1С».

## Информационные базы

| Задача                                | Command ID                                          |
|---------------------------------------|-----------------------------------------------------|
| Создать пустую ИБ                     | `1c-platform-tools.infobase.createEmpty`            |
| Обновить ИБ                           | `1c-platform-tools.infobase.updateInfobase`         |
| Постобработка обновления              | `1c-platform-tools.infobase.updateDatabase`         |
| Запретить работу с внешними ресурсами | `1c-platform-tools.infobase.blockExternalResources` |
| Инициализировать данные               | `1c-platform-tools.infobase.initialize`             |
| Выгрузить в dt                        | `1c-platform-tools.infobase.dumpToDt`               |
| Загрузить из dt                       | `1c-platform-tools.infobase.loadFromDt`             |

## Конфигурация

| Задача                                | Command ID                                             |
|---------------------------------------|--------------------------------------------------------|
| Загрузить конфигурацию из src/cf      | `1c-platform-tools.configuration.loadFromSrc`          |
| Загрузить только изменения (git diff) | `1c-platform-tools.configuration.loadIncrementFromSrc` |
| Загрузить из objlist.txt              | `1c-platform-tools.configuration.loadFromFilesByList`  |
| Загрузить из 1Cv8.cf                  | `1c-platform-tools.configuration.loadFromCf`           |
| Выгрузить конфигурацию в src/cf       | `1c-platform-tools.configuration.dumpToSrc`            |
| Выгрузить изменения в src/cf          | `1c-platform-tools.configuration.dumpIncrementToSrc`   |
| Выгрузить в 1Cv8.cf                   | `1c-platform-tools.configuration.dumpToCf`             |
| Собрать 1Cv8.cf из src/cf             | `1c-platform-tools.configuration.build`                |
| Разобрать 1Cv8.cf в src/cf            | `1c-platform-tools.configuration.decompile`            |

## Расширения

| Задача                          | Command ID                                         |
|---------------------------------|----------------------------------------------------|
| Загрузить расширение из src/cfe | `1c-platform-tools.extensions.loadFromSrc`         |
| Загрузить из objlist.txt        | `1c-platform-tools.extensions.loadFromFilesByList` |
| Загрузить из *.cfe              | `1c-platform-tools.extensions.loadFromCfe`         |
| Выгрузить расширение в src/cfe  | `1c-platform-tools.extensions.dumpToSrc`           |
| Выгрузить в *.cfe               | `1c-platform-tools.extensions.dumpToCfe`           |
| Собрать *.cfe из src/cfe        | `1c-platform-tools.extensions.build`               |
| Разобрать *.cfe в src/cfe       | `1c-platform-tools.extensions.decompile`           |

## Внешние обработки и отчёты

| Задача                      | Command ID                                       |
|-----------------------------|--------------------------------------------------|
| Собрать внешнюю обработку   | `1c-platform-tools.externalProcessors.build`     |
| Разобрать внешнюю обработку | `1c-platform-tools.externalProcessors.decompile` |
| Собрать внешний отчёт       | `1c-platform-tools.externalReports.build`        |
| Разобрать внешний отчёт     | `1c-platform-tools.externalReports.decompile`    |
| Удалить кэш                 | `1c-platform-tools.externalFiles.clearCache`     |

## Поддержка и поставка

| Задача                                       | Command ID                                                |
|----------------------------------------------|-----------------------------------------------------------|
| Выгрузить в 1Cv8dist.cf                      | `1c-platform-tools.configuration.dumpToDist`              |
| Загрузить из cf/cfu                          | `1c-platform-tools.support.updateCfg`                     |
| Удалить поддержку                            | `1c-platform-tools.support.disableCfgSupport`             |
| Создать файл описания шаблона поставки       | `1c-platform-tools.support.createDeliveryDescriptionFile` |
| Создать файлы поставки и обновления (cf/cfu) | `1c-platform-tools.support.createDistributionFiles`       |
| Создать комплект поставки                    | `1c-platform-tools.support.createDistributivePackage`     |
| Создать файл списка шаблонов                 | `1c-platform-tools.support.createTemplateListFile`        |

## Зависимости и проект

| Задача                                 | Command ID                                                  |
|----------------------------------------|-------------------------------------------------------------|
| Инициализировать проект (packagedef)   | `1c-platform-tools.dependencies.initializePackagedef`       |
| Инициализировать структуру проекта     | `1c-platform-tools.dependencies.initializeProjectStructure` |
| Настроить Git                          | `1c-platform-tools.dependencies.setupGit`                   |
| Установить OneScript                   | `1c-platform-tools.dependencies.installOscript`             |
| Установить пакетный менеджер OneScript | `1c-platform-tools.dependencies.updateOpm`                  |
| Установить зависимости                 | `1c-platform-tools.dependencies.install`                    |
| Удалить зависимости                    | `1c-platform-tools.dependencies.remove`                     |

### Порядок при настройке зависимостей

1. **Сначала проверь инструменты MCP** (сервер mcp-1c-platform-tools). В нём есть:
   - **deps_install** — установка зависимостей проекта (packagedef, vrunner и т.п.).
   - **deps_installOscript** — установка зависимостей OneScript (opm add, модули вроде vanessa-automation-single).
   Если MCP доступен — вызывай эти инструменты с нужным `projectPath`; **не переходи в терминал** с `opm install add` по привычке.

2. **Проверка OneScript**: если нужно подготовить окружение — проверь наличие **oscript** в системе. Если oscript **нет** — вызови установку (`1c-platform-tools.dependencies.installOscript` или MCP-аналог). Если oscript **уже есть** — выполняй только установку зависимостей (через MCP: `deps_install` и при необходимости `deps_installOscript`; или команды расширения `dependencies.install` / `dependencies.updateOpm`).

3. К терминалу (opm, vrunner вручную) прибегай только если MCP недоступен или инструменты не покрывают сценарий.

## Запуск

| Задача                 | Command ID                         |
|------------------------|------------------------------------|
| Запустить Предприятие  | `1c-platform-tools.run.enterprise` |
| Запустить Конфигуратор | `1c-platform-tools.run.designer`   |

## Тестирование

| Задача                  | Command ID                           |
|-------------------------|--------------------------------------|
| XUnit тесты             | `1c-platform-tools.test.xunit`       |
| Синтаксический контроль | `1c-platform-tools.test.syntaxCheck` |
| Vanessa тесты           | `1c-platform-tools.test.vanessa`     |
| Allure отчёт            | `1c-platform-tools.test.allure`      |

## Установить версию

| Задача                         | Command ID                                   |
|--------------------------------|----------------------------------------------|
| Установить версию конфигурации | `1c-platform-tools.setVersion.configuration` |

## Конфигурации запуска

| Задача              | Command ID                                    |
|---------------------|-----------------------------------------------|
| Открыть env.json    | `1c-platform-tools.config.env.edit`           |
| Открыть launch.json | `1c-platform-tools.launch.editConfigurations` |

## MCP

Если у тебя есть инструменты MCP **mcp-1c-platform-tools**, используй их для тех же операций: загрузка конфигурации — `configuration_loadFromSrc`, выгрузка — `configuration_dumpToSrc`, расширения — `extensions_loadFromSrc` / `extensions_dumpToSrc`, сборка/разбор обработок и отчётов — `externalProcs_build`, `externalReports_build`, `externalProcs_decompile`, `externalReports_decompile` и т.д. **Для зависимостей** — в первую очередь вызывай **deps_install** и **deps_installOscript**; не переходи в терминал с `opm install add`, пока не убедился, что MCP недоступен. В каждый вызов передавай `projectPath` — корень проекта 1С (каталог с `packagedef`). Имена формируются из command ID: убирается префикс, точки → `_`, длинные слова сокращаются (`dependencies` → `deps`, `Processors` → `Procs`). Полный список возвращается сервером при подключении.

## Дополнительные навыки (Claude Code)

Навык 1c-platform-tools отвечает за **пакетные операции**: загрузка/выгрузка конфигурации и расширений, сборка/разбор EPF/ERF, запуск Конфигуратора/Предприятия — через команды расширения или MCP. Для **редактирования XML-исходников, создания объектов метаданных, валидации форм/ролей/СКД** можно дополнительно использовать набор [cc-1c-skills](https://github.com/Nikolay-Shirokov/cc-1c-skills) (Claude Code): скопируй `.claude/skills/` из того репозитория в корень проекта — появятся слэш-команды (`/epf-build`, `/cf-edit` и др.). Итого: команды расширения и MCP — за «что запустить» (load/dump/build); cc-1c-skills — за «как править и генерировать» XML и объекты. Актуальность cc-1c-skills поддерживай обновлением копии из репозитория по желанию пользователя.

## Правило

Для любой операции (запуск Конфигуратора/Предприятия, загрузка конфигурации, сборка и т.д.) — **сразу выполни команду расширения** по таблице выше через свой инструмент выполнения команд (или MCP, если доступен). Не перекладывай на пользователя («нажмите Ctrl+Shift+P», «из чата вызвать нельзя»). Только если у тебя нет инструмента для выполнения команд — тогда подскажи палитру или панель «Инструменты 1С». Не запускай bat-файлы или 1cv8 вручную; настройки заданы в проекте (env.json).