1c-platform-tools

---

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
Установить пакетный менеджер	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

Метаданные и 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).