Skill для ИИ, который научил его отлаживать 1С: смотреть переменные, идти по шагам и глубже разбирать код

Переносимый runtime-пакет и skill для ИИ, с которыми агент может не только читать исходники 1С, но и запускать live-отладку, видеть реальные значения переменных, вычислять выражения и разбирать поведение кода на исполнении.

Что это за продукт

Это готовый переносимый комплект из runtime-пакета и skill для ИИ. Его можно перенести на другой компьютер без установки среды разработки самого инструмента. Главная практическая ценность в том, что отладка становится доступна не только человеку, но и ИИ: агент через skill получает понятный способ запускать сессию, ставить точки останова, читать стек, смотреть переменные, вычислять выражения и собирать технические артефакты через shell-команды.

Процедура ПередНачаломРаботыСистемы(Отказ)
	Товар = Неопределено;
	Количество = 100;
	Число = "Число";
	ПроизвольнаяПеременная = "ПроизвольнаяПеременная";
	Цена = 1500.50;

	Если Товар <> Неопределено Тогда
		Сумма = Количество * Цена;
		Сообщить("Итого: " + Сумма);
	КонецЕсли;

	ГСВ = Новый ГенераторСлучайныхЧисел();

	Для Индекс = 1 По 10 Цикл
		оп = ГСВ.СлучайноеЧисло(1, 100);
		ПроизвольнаяПеременная = "ПроизвольнаяПеременная" + оп;
		Сообщить(Индекс);
	КонецЦикла;

	Сообщить("1");
	Сообщить("2");
КонецПроцедуры

Главный результат

ИИ теперь умеет не просто читать код 1С, а отлаживать его через подключенный skill: останавливаться на нужной строке, смотреть реальные значения, проходить код по шагам и использовать полученные данные, чтобы разбираться в прикладной логике глубже и точнее.

После подключения пакета ИИ получает не абстрактный доступ к "отладке вообще", а набор конкретных технических возможностей.

• запуск отлаживаемой сессии 1С в режиме launch;
• установка breakpoints по файлу и строке;
• получение списка thread'ов и стека вызовов;
• чтение локальных переменных и вложенных значений;
• вычисление выражений в текущем контексте;
• пошаговое выполнение через continue, next, step-in, step-out;
• съем отчетов по шагам и наблюдение за отдельной переменной или выражением;
• повторная работа с уже поднятой debug-сессией без нового cold launch.

То есть ИИ может не только сказать "здесь, вероятно, проблема", но и подтвердить это отладкой: показать, что именно пришло в переменную, как оно изменилось, где пошло расхождение и на каком шаге поведение стало отличаться от ожидаемого.

Ниже пример того, что ИИ получает не в виде догадки по коду, а в виде фактического результата отладочного прогона. В этом сценарии агент следил за выражением ПроизвольнаяПеременная и собрал все изменения значения по остановкам.

То есть ИИ видит не просто сам факт цикла, а конкретную последовательность значений, которые реально возникли во время исполнения. Именно за счет этого он может объяснять поведение кода уже на уровне факта, а не гипотезы.

Что меняется в практике

ИИ перестает быть только помощником по чтению исходников и становится помощником по реальной диагностике. Он может пройти по исполнению, увидеть значения и использовать их, чтобы точнее объяснить проблему, предложить исправление или подтвердить, что подозреваемый участок действительно ведет себя неправильно.

С практической точки зрения схема подключения очень простая. На целевой машине нужны две части: runtime и skill.

1. Распаковать runtime-пакет рядом с рабочим проектом или в отдельную служебную папку.
2. Заполнить launch-конфиг: пути к платформе 1С, параметры базы, рабочую директорию, логин и пароль, breakpoints при необходимости.
3. Скопировать папку skill в каталог skills того ИИ или агентной среды, через которую планируется работа.
4. Убедиться, что ИИ через skill видит доступные команды и может вызывать shell-команды на этой машине.
5. После этого ИИ можно давать уже прикладные задачи: запусти отладку, покажи стек, прочитай переменные, отследи выражение, собери отчет по остановкам.

То есть сам skill не содержит внутри отладчик. Skill - это пользовательский слой, который учит ИИ правильно пользоваться уже поставленным runtime-пакетом.

Если говорить совсем коротко, то подключение выглядит так: сначала кладем runtime на машину, потом подключаем skill к ИИ, после этого ИИ начинает пользоваться отладчиком как рабочим инструментом.

Чтобы человек сразу понял, как этим пользоваться, схему можно свести к трем сущностям:

• runtime/ - папка с onec_debug_adapter.exe, onec_debug_cli.exe и launch-конфигом;
• skill/ - папка skill, которую нужно подключить к своей AI-среде;
• launch.template.json - файл, где прописываются пути к 1С, параметры базы, путь к исходникам и breakpoints.

Практически это выглядит так: runtime кладется на машину, рядом лежит проект или dump исходников 1С, skill подключается в среду ИИ, launch-конфиг настраивается под конкретную базу и путь к исходникам, после чего ИИ уже может вызывать готовые команды и работать с отладкой.

Для пользователя это означает, что он подключает не "абстрактную интеграцию", а вполне понятный набор: папка с инструментом, папка со skill, проект или dump исходников и файл конфигурации запуска.

onec_debug_ai_ready_package/
  runtime/
    bin/
      onec_debug_adapter.exe
      onec_debug_cli.exe
    configs/
      launch.template.json
  dart_sources/
    bin/
    lib/
    test/
    pubspec.yaml
  skill/
    onec-dap-debugging/
      SKILL.md
      references/
      agents/
  03_PACKAGE_CONTENTS.md

Со стороны ИИ здесь не требуется специальная магия. Нужны три базовые возможности:

• уметь подключать локальный skill;
• уметь запускать shell-команды на машине, где лежит runtime;
• уметь читать файлы-артефакты: JSON, markdown-отчеты и конфигурацию запуска.

Если агентная среда это поддерживает, то дальше она может использовать наш skill как обычный рабочий инструмент. Отдельный DAP-клиент ИИ писать не нужно, потому что большая часть прикладной работы уже закрыта готовыми CLI-командами.

После подключения skill пользователь может ставить ИИ уже прикладные задачи в естественной форме. Например:

Или другой пример:

Пакет построен как универсальный runtime. На целевой машине лежат готовые исполняемые файлы, launch-конфиг и документация. Внешняя автоматизация работает через CLI-команды, а при необходимости можно использовать и DAP-слой как техническую основу для отдельного IDE-клиента.

С точки зрения эксплуатации это удобно по нескольким причинам:

• не требуется отдельная разработческая среда для самого инструмента;
• можно запускать пакет на другом ПК как готовое решение;
• одни и те же команды подходят для человека, shell-сценария и AI-агента;
• конфигурация хранится в одном launch JSON, а не размазана по разным ручным настройкам.

За счет этого решение позиционируется не как внутренняя заготовка, а как самостоятельный универсальный продукт: переносимый runtime плюс skill, через который ИИ получает доступ к live-отладке 1С.

• runtime/bin/onec_debug_adapter.exe - отладочный адаптер;
• runtime/bin/onec_debug_cli.exe - CLI для shell и AI-сценариев;
• runtime/configs/launch.template.json - шаблон launch-конфига;
• dart_sources/ - исходники проекта на Dart: bin, lib, test, pubspec.yaml и сопутствующие файлы;
• папка skill для подключения к ИИ или агентной среде;
• документация по запуску и диагностике;
• 03_PACKAGE_CONTENTS.md - отдельный файл состава поставки с кратким назначением каждого элемента;
• готовый zip-пакет для переноса на другой компьютер.

Целевая машина не требует установки Dart SDK. Достаточно платформы 1С, доступа к базе, самого runtime-набора и подключенного skill в той AI-среде, через которую планируется работа.

Пакет тестировался на платформе 1С:Предприятие 8.3.27.1936.

При этом решение не привязано к какой-то одной прикладной конфигурации. Оно рассчитано не на конкретную базу, а на универсальный launch-сценарий отладки 1С. Поэтому при корректно заполненном launch-конфиге, доступной платформе, рабочей базе и актуальных исходниках пакет может использоваться с любой конфигурацией 1С.

Иными словами, ограничение здесь идет не по прикладной конфигурации, а по техническим условиям запуска: версия платформы, доступность dbgs.exe, корректные параметры базы и наличие проекта или dump исходников для привязки breakpoint'ов.

Технически пакет построен на собственном DAP-адаптере и CLI-клиенте. Внутри используется стек, ориентированный на RDBG HTTP/XML и automation-friendly работу через shell-команды.

• основная реализация выполнена на Dart;
• снаружи пакет отдает DAP-интерфейс и CLI-команды;
• взаимодействие с 1С идет через dbgs.exe и отладочный HTTP/XML слой платформы;
• для проектирования и сверки поведения в качестве "настольной книги" использовался open-source проект akpaevj/onec-debug-adapter.

Это важно именно как честное позиционирование: речь не о перепаковке чужого решения, а о собственной реализации, которую мы строили, постоянно сверяясь с уже существующим рабочим open-source ориентиром.

• целевая платформа текущей версии - Windows;
• основной рабочий сценарий текущей версии - launch;
• для надежной привязки breakpoint'ов нужен актуальный dump исходников;
• cold start ограничен реальным запуском 1С и attach debug target;
• локальные защитные средства, включая агрессивный антивирус, могут мешать EXE и session-daemon.

То есть это уже рабочий инструмент для практического использования, но с четко обозначенными рамками текущей фазы.