1C:Enterprise Agent Toolkit
Универсальные Agent Skills для безопасной работы с расширениями 1С: изолированная сессия, выборочная выгрузка и проверка перед применением
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Запускает пакетный режим Конфигуратора и может создавать, загружать и удалять расширения
- Прямая работа с живой базой возможна только через явные флаги --allow-live-base и --no-sandbox
Установка
Ручная установка
py install.py --agent codexПосле клонирования репозитория, перезапустить Codex и вызвать навык командой $onec-dev.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Тулкит дает четыре навыка, которые работают с любой прикладной конфигурацией 1С:Предприятие: onec-dev выбирает безопасный сценарий и следит за границами изменений, onec-selective-export выгружает только нужные объекты через ключ -listFile пакетного Конфигуратора, onec-extension-lifecycle создает, выгружает, загружает, резервирует, откатывает и удаляет одно расширение, onec-extension-validate проверяет BSL, конфигурацию, применимость и итоговый cfe-файл. Работа всегда идет в изолированной маркированной копии файловой базы: очистка отклоняет корень диска, домашнюю и текущую папку и неверный маркер, пароль передается только через имя переменной окружения. Общий CLI scripts/onec.py написан на стандартной библиотеке Python без сторонних зависимостей, ставится плагином командой install.py для Codex или Claude Code, структура skills/<name>/SKILL.md переносима на других агентов.
Для кого. Для 1С-разработчиков, которые дают агенту доступ к расширениям конфигурации и хотят гарантий, что он не заденет основную базу.
Подходит, если
- Нужно, чтобы агент правил расширения 1С в изолированной копии, а не в рабочей базе
- Нужна выборочная выгрузка только нужных объектов метаданных без полного дампа
- Работаете и с Claude Code, и с Codex и хотите единые скиллы для обоих
Не подходит, если
- Нужна работа с типовыми объектами УНФ из коробки: тулкит не завязан на конкретную конфигурацию
- Нет установленной платформы 1С и информационной базы: они не входят в проект
- Нужна работа сразу с живой базой без изолированной сессии: включается только явным флагом --allow-live-base
Пример запроса к агенту
Создай изолированную сессию для базы C:\1cbase, выгрузи из нее только справочник Номенклатура и покажи структуруОграничения
Платформа 1С и информационная база не входят в проект, их нужно иметь отдельно. Интеграционно протестирован на конфигурации УНФ и платформе 8.5.1.1343, для других конфигураций и версий гарантий меньше. Работа с живой базой требует явного флага --allow-live-base и, для файловой базы, дополнительно --no-sandbox. README прямо просит проверить работу на одноразовой копии базы перед первым использованием.
Как отключить. Удалите папку skills/onec-* и файлы .claude-plugin/plugin.json или .codex-plugin/plugin.json из установки агента, либо просто не используйте команды $onec-dev.
Проверка безопасности
- Запускает пакетный режим Конфигуратора и может создавать, загружать и удалять расширения
- Прямая работа с живой базой возможна только через явные флаги --allow-live-base и --no-sandbox
Коротко о README
README описывает установку за 60 секунд через install.py, таблицу четырех скиллов, схему безопасного цикла (копирование базы, изолированная сессия, выборочная выгрузка, изменение расширения, проверка, удаление только данных сессии), гарантии очистки и передачи пароля, пример первого безопасного запуска через scripts/onec.py, таблицу совместимости с Codex, Claude Code и другими агентами, требования к проверке через unittest и план развития.
Частые вопросы
Тулкит работает только с УНФ?
Нет, объекты метаданных не зашиты в код, имена всегда передаются явно; УНФ использовалась только для интеграционного теста.
Как агент получает пароль от базы?
Пароль не передается напрямую, а только через имя переменной окружения, значение которой агент не видит.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything