Инструменты по категориям
Pi 1C Agent меняет метаданные через навык 1c-metadata-manage и поставляемые скрипты, работающие с XML-выгрузкой Конфигуратора. На входе — файлы объектов или JSON-описания; результат записывается в локальное дерево исходников. Для EDT MDO требуется отдельная EDT-интеграция.
Локальные команды по метаданным
meta-info | чтение состава и свойств объекта из XML. |
|---|---|
meta-compile, meta-edit, meta-remove | создание, изменение или удаление объекта; редактирование запускает проверку полученной структуры. |
cf-init, cf-info, cf-edit | каркас конфигурации, сведения и изменение её состава. |
cfe-init, cfe-borrow, cfe-diff, cfe-patch-method | каркас расширения, заимствование объектов, сравнение и подготовка изменения метода. |
subsystem-info, subsystem-compile, subsystem-edit | подсистемы и их состав; interface-edit — командный интерфейс. |
role-info, role-compile | чтение прав роли и формирование XML роли. |
support-edit | явное изменение состояния поддержки; обычные изменяющие команды проверяют поддержку объекта перед записью. |
Есть скрипты валидации для объектов, конфигураций, расширений, подсистем, интерфейса и ролей. По умолчанию заблокированные объекты на поддержке не редактируются; параметры проекта управляют реакцией проверки. Большинство операций требуют Windows/PowerShell; Python-порты доступны у meta-edit и meta-validate, а также трёх команд форм. Индексный поиск и чтение метаданных живой EDT или базы требуют отдельно подключённых инструментов.
Pi 1C Agent создаёт и меняет управляемые формы в XML-выгрузке Конфигуратора через локальный навык 1c-metadata-manage. Структура и описание формы читаются с диска; JSON DSL преобразуется в XML, а форма регистрируется в объекте конфигурации.
Команды по формам
form-info | чтение структуры формы, элементов и связанных свойств из XML. |
|---|---|
form-add | создание формы с описанием, XML, модулем и регистрацией в объекте. |
form-compile | генерация XML формы по JSON DSL или метаданным объекта, включая реквизиты, команды, параметры и привязки обработчиков. |
form-edit | правки существующих элементов и структуры. |
form-validate | проверка структуры полученного XML. |
remove-form | удаление формы с предварительным dry run; для изменения нужен явный Force. |
v8unpack-cf | навык работы с обычными бинарными формами через отдельно установленный v8unpack или MCP упаковки/распаковки. |
Python-порты с lxml есть у form-add, remove-form, form-compile; для полного набора нужен Windows/PowerShell. Проверка поддержки объекта может блокировать запись. EDT MDO/Form.form этими скриптами не обрабатывается: для этого профилем предусмотрена работа через внешнюю EDT-интеграцию. XML-валидация не заменяет открытие формы и проверку поведения в 1С.
Pi 1C Agent работает со схемами компоновки данных и табличными макетами через локальные скрипты навыка 1c-metadata-manage. Скрипты читают XML-выгрузку Конфигуратора и JSON DSL и записывают XML-артефакты; сборка внешнего отчёта выполняется установленной платформой.
Команды и навыки по отчётам
skd-info, skd-decompile | чтение схемы СКД и преобразование её описания для дальнейшей работы. |
|---|---|
skd-compile | генерация XML схемы по JSON-описанию. |
skd-edit, skd-validate | изменение схемы и проверка её структуры. |
mxl-info, mxl-decompile, mxl-compile, mxl-validate | чтение, преобразование, создание и проверка табличных макетов. |
img-grid-analysis | разметка исходного изображения сеткой для подготовки макета печатной формы. |
epf-build, epf-dump | сборка или выгрузка внешней обработки/отчёта через CLI Конфигуратора. |
Нужен Windows/PowerShell; эти команды не входят в пять поставляемых Python-портов. Генерация и проверка XML не подтверждают корректность исполнения запроса СКД или внешнего отчёта: запуск и прикладная проверка требуют базы и платформы 1С. Живая EDT доступна только после отдельного подключения.
Pi 1C Agent организует ревью через отдельные роли Pi, которые получают явный список файлов или переданный родительским агентом diff. Для синтаксиса и статических диагностик используются отдельно подключённые анализаторы или MCP, а процедуры загрузки и сборки предусматривают пакетные проверки установленным Конфигуратором 1С.
Роли и навыки проверки
1c-code-reviewer | проверка переданного BSL-кода по требованиям задачи, правилам проекта, стилю и потенциальным дефектам; без предоставленной области проверки запрашивает её вместо догадок. |
|---|---|
1c-arch-reviewer | отдельное архитектурное ревью изменения. |
1c-performance-optimizer | анализ производительности и предложения по оптимизации. |
1c-error-fixer | исправление выявленного дефекта с повторной проверкой. |
mcp-1c-tools | маршрутизация синтаксиса и статических диагностик к доступному BSL Language Server, EDT или серверу проверки; такой сервер устанавливается отдельно. |
/CheckModules, /CheckCanApplyConfigurationExtensions | проверки модулей и применимости загружаемого расширения через CLI Конфигуратора до обновления структуры базы; /CheckConfig применяется для основной конфигурации по условиям процедуры. |
Роли запускаются собственным механизмом дочерних процессов Pi и зависят от выбранной LLM. Ревьюер не исполняет shell и не получает Git diff самостоятельно: область передаёт родитель. Доступность конкретных диагностик определяется внешним анализатором или платформой; пакетные проверки требуют базы и анализируются по коду завершения и журналам. Текстовый результат ревью не является подтверждением успешной компиляции.
Pi 1C Agent предоставляет команды тестового цикла и навык vanessa-mcp. Загрузка исходников в тестовую базу идёт через локальные скрипты и CLI платформы. Проверки веб-клиента выполняются через отдельно установленный agent-browser, а Gherkin-сценарии — через внешний Vanessa MCP с клиентом тестирования 1С.
Команды и навыки по тестированию
/deploy-and-test | загрузка XML-исходников в явно выбранную тестовую базу, пакетные проверки модулей и применимости расширений, применение конфигурации и дальнейшие UI-проверки веб-клиента через agent-browser. UI-этап управляется настройкой: off, manual или auto; manual используется по умолчанию и требует явного запроса тестов. |
|---|---|
/test-fix-loop | процедура повторения deploy → test → fix с учётом результатов предыдущего прогона. |
vanessa-mcp | получение состояния тестового клиента, поиск готовых шагов, подготовка Gherkin, проверка синтаксиса, запуск сценария и чтение результата через отдельно подключённый Vanessa MCP. |
1c-tester | подготовка тестовых сценариев и отчёта о проверке средствами доступного тестового контура. |
Требуются платформа и тестовая база; для веб-проверки — опубликованный веб-клиент и agent-browser, для Vanessa — внешний MCP, тест-менеджер, клиент тестирования и соответствующие обработки/расширения. Их бинарники не поставляются. Поиск шагов и проверка синтаксиса предшествуют запуску Vanessa; недоступный контур не выдаётся за успешный прогон. Обновление тестовой базы может принудительно завершать сеансы; команда требует явно установленной тестовой цели. Сценарии тестирования выполняются агентом по процедурам профиля, отдельного собственного MCP runner нет.
Pi 1C Agent содержит навык 1c-mcp-toolkit с локальными HTTP-обёртками для живого сеанса 1С. Скрипты передают JSON в API внешней обработки MCP Toolkit, запущенной внутри клиента 1С; по умолчанию обращаются к localhost с настраиваемым портом. Это отдельный контур от XML-правок и от внешнего MCP bundle.
Навыки и операции по данным
1c-mcp-toolkit | проверка доступности HTTP API, выполнение языка запросов 1С через /api/execute_query и BSL из файла через /api/execute_code; доступны PowerShell и Bash-обёртки. |
|---|---|
kd2-rules | чтение и изменение правил КД 2 через запросы и BSL в базе КД, затем выгрузка XML правил обмена. |
kd31-rules | чтение и изменение правил КД 3.1, настройка EnterpriseData и подготовка модуля менеджера обмена в базе КД через тот же HTTP-контур. |
Нужны запущенная база и отдельно полученная обработка MCP Toolkit; для навыков КД — соответствующая конфигурация базы. Для Bash-обёрток нужны curl и jq либо Python для формирования JSON. Скрипты могут сохранить ответ в файл; сетевой таймаут не доказывает отмену BSL в базе. Права и ограничения определяет внешняя обработка и пользователь сеанса. BSL и правила конвертации могут изменять данные; профиль не добавляет отдельный режим только чтения для этих HTTP-вызовов.
Pi 1C Agent работает как терминальный профиль Pi Coding Agent над файловым проектом 1С. Собственный пакет создаёт каркас и настройки, а команды профиля направляют агента к локальным скриптам, запускающим Конфигуратор или ibcmd. Основной формат — XML/BSL-выгрузка; для живой EDT подключается отдельный MCP.
Команды и навыки работы со средой
/init | мастер с предварительным просмотром и Apply: каркас исходников и сборки, параметры базы, знания проекта, OpenSpec; исходная конфигурация может поступать из базы, CF или DT. |
|---|---|
/doctor | проверка состояния профиля, пакета и проекта. |
/loadfrom1cbase, /getconfigfiles | полная или выборочная выгрузка источников из базы средствами платформы. |
/update1cbase | загрузка исходников основной конфигурации и расширений в указанную базу с обновлением структуры через Конфигуратор или ibcmd. |
/build-release | сборка CF/CFE из зафиксированного Git-снимка через сборочную базу, с проверкой наличия полученных артефактов. |
/restore-testbase | восстановление явно выбранной тестовой базы из снимка. |
1c-repository-manage | операции хранилища конфигурации через CLI Конфигуратора: состояние, история, сравнение, захват, обновление, помещение, освобождение, выгрузка. |
/installtools, /checkmcp | выбор отдельно устанавливаемых инструментов и проверка подключений; /update-profile, /update-pi-cli — обновление профиля и оболочки Pi. |
Требуются Pi, Node.js, Git, настроенная LLM и для операций базы — установленная платформа и параметры подключения. Команды сборки/загрузки являются процедурами для агента, использующими поставляемые скрипты; /init и /doctor исполняются расширениями Pi. Восстановление базы и обновление конфигурации могут менять данные и завершать сеансы. Полный набор платформенных скриптов рассчитан на Windows; наличие PowerShell на Linux/macOS не гарантирует работу Windows-зависимых операций.
Pi 1C Agent — готовый профиль и пакет расширений для Pi Coding Agent. Правила, навыки и специализированные роли работают вместе с собственными tools Pi; внешние MCP подключаются отдельно. В поставке есть 24 навыка профиля и 3 навыка пакета.
Собственные tools и управление работой
subagent_1c | запуск роли отдельным процессом Pi: одиночная задача, параллельные задачи или цепочка с передачей результата; права роли и активный режим ограничивают выполнение. |
|---|---|
workflow_1c | исполнение именованного сценария в BUILD с передачей результатов между этапами и проверкой финального отчёта. Изменяющие общий рабочий каталог этапы идут последовательно. |
/mode | ASK для вопросов, PLAN для исследования и плана, BUILD для реализации; /agents показывает доступные роли. |
/approve, /anon | режим подтверждения действий и ограничения памяти/локальных следов. |
/session-rotate | перенос задачи в новую Pi-сессию через сохранённый handoff при заполнении контекста; по умолчанию выключен. |
Навыки пакета
1c-orchestrator | маршрутизация задач между ролями и сценариями разработки. |
|---|---|
1c-openspec | исследование, предложение, реализация и проверка через OpenSpec. |
1c-knowledge | использование подтверждённых фактов и правил проекта или конфигурации. |
Навыки профиля
1c-metadata-manage | XML-метаданные, формы, СКД, MXL, роли, конфигурации, расширения, внешние объекты и операции с базой через локальные скрипты. |
|---|---|
1c-repository-manage | хранилище конфигурации 1С: захват объектов, обновление, история, сравнение, помещение изменений и освобождение. |
mcp-1c-tools | выбор подходящего отдельно подключённого MCP для поиска, метаданных, документации и проверок. |
1c-mcp-toolkit | HTTP-доступ к запросам и BSL в живой базе через внешнюю обработку MCP Toolkit. |
kd2-rules | правила конвертации КД 2 и выгрузка XML через живую базу КД и MCP Toolkit. |
kd31-rules | правила КД 3.1, EnterpriseData и модуль менеджера обмена через живую базу КД и MCP Toolkit. |
vanessa-mcp | подготовка и проверка Gherkin-сценариев, запуск и анализ результатов через внешний Vanessa MCP. |
v8unpack-cf | работа с бинарными CF/CFE/EPF и обычными формами через отдельно установленный v8unpack или MCP. |
img-grid-analysis | разметка изображения сеткой для подготовки макета печатной формы. |
context-bootstrap | первичное определение проекта, источников контекста и доступной памяти. |
context-router | выбор между текущими файлами, памятью и документами проекта. |
knowledge-retrieval | поиск документации и индексированных знаний через OpenViking. |
shared-memory | чтение и запись долговременных фактов через Cognee. |
memory-maintenance | поиск дубликатов, устаревших и противоречивых записей памяти. |
memory-safety | отбор подтверждённых сведений для сохранения без секретов и временных результатов. |
session-handoff | компактная передача итогов сессии и сохранение полезной части в память. |
handoff | подготовка самостоятельного документа для продолжения задачи другим агентом. |
powershell-windows | правила исполнения скриптов, HTTP-запросов и команд на Windows. |
prompt-enhancer | структурирование задания с сохранением исходных требований. |
caveman | сокращённый стиль ответов агента. |
humanizer-ru | редактура русского текста. |
md-to-docx | преобразование Markdown в DOCX. |
mermaid-diagrams | подготовка диаграмм Mermaid. |
transcribe | расшифровка аудио и видео через Gemini API. |
Роли
1c-analytic, 1c-explorer, 1c-planner, 1c-developer, 1c-tester, 1c-code-reviewer, 1c-arch-reviewer, 1c-architect, 1c-error-fixer, 1c-performance-optimizer, 1c-metadata-manager, 1c-refactoring, 1c-doc-writer.
Нужны Pi 0.85.x, Node.js 22.19+, Git и доступ к выбранной модели. MCP-конфигурация изначально пуста; платный 1С bundle, EDT, Vanessa и память подключаются отдельно. Полный набор 1С-скриптов рассчитан на Windows/PowerShell; Python-порты есть только для пяти команд форм и метаданных. Дополнительные навыки Vanessa, КД и Toolkit имеют beta-статус, их внешние обработки и расширения не входят в поставку.
Pi 1C Agent хранит общие правила разработки 1С в локальном профиле, а сведения конкретного проекта — в локальном слое знаний. Факты, правила, предпочтения и предположения сохраняются с областью применения и ссылками на доказательства; актуальные исходники остаются основанием для проверки.
Инструменты и команды по методологии
knowledge_1c | выборка локальных фактов и правил по запросу, областям и видам сведений, с ранжированием по приоритету; по умолчанию до 12 записей. |
|---|---|
/learn | подготовка черновика знания; approve/reject управляют его активацией. |
/rule | добавление проектного или конфигурационного правила через черновик. |
/config analyze | анализ в PLAN с предложениями новых знаний, без их автоматической активации. |
/config update | сопоставление отпечатков исходников после обновления конфигурации и подготовка добавлений, изменений или инвалидирования знаний; /config apply применяет черновик в BUILD. |
1c-openspec, /openspec-setup | подключение OpenSpec к проекту и работа с требованиями, предложением, реализацией и проверкой. |
/bootstrap | установка закреплённого снимка общих правил в область проекта или профиля. |
Приоритет
проектные правила и предпочтения, затем правила конфигурации, подтверждённые факты конфигурации и общие правила 1С. Для локальных знаний проект должен быть доверенным. Cognee/OpenViking — отдельный необязательный контур долговременной памяти и документов; он требует подключённых сервисов. Поиск локальных знаний не обращается к ИТС и не подтверждает корректность сохранённого факта без его исходных доказательств.