| 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 |
Порядок при настройке зависимостей
-
Сначала проверь инструменты MCP (сервер mcp-1c-platform-tools). В нём есть:
- deps_install — установка зависимостей проекта (packagedef, vrunner и т.п.).
- deps_installOscript — установка зависимостей OneScript (opm add, модули вроде vanessa-automation-single).
Если MCP доступен — вызывай эти инструменты с нужным
projectPath; не переходи в терминал с opm install add по привычке.
-
Проверка OneScript: если нужно подготовить окружение — проверь наличие oscript в системе. Если oscript нет — вызови установку (1c-platform-tools.dependencies.installOscript или MCP-аналог). Если oscript уже есть — выполняй только установку зависимостей (через MCP: deps_install и при необходимости deps_installOscript; или команды расширения dependencies.install / dependencies.updateOpm).
-
К терминалу (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 |
Метаданные и ER-диаграмма
| Задача | Command ID |
|---|
| Открыть конструктор ER-диаграммы | 1c-platform-tools.metadata.er.openBuilder |
| Построить ER-диаграмму по подсистеме | 1c-platform-tools.metadata.er.generateForSubsystem |
| Построить ER-диаграмму по объекту | 1c-platform-tools.metadata.er.generateForObject |
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 (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).