Фреймворк агентной разработки для 1С

1C BSL Agent Development Framework

Модульный фреймворк агентной разработки на 1С: навыки, правила, сабагенты и воркфлоу по SDD и TDD с кросс-ревью

ВоркфлоуВысокий рискРоссийский стек

steelmorgan/1c-agent-based-dev-framework

Установка

python tools/install.py

Запускать из каталога фреймворка. Инсталлятор спросит IDE, каталог проекта и набор файлов. Для Claude и Codex создайте корневой CLAUDE.md или AGENT.md.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Фреймворк настраивает агентов для работы с конфигурациями 1С через MCP-серверы. В сабагентном режиме оркестратор ведет полный цикл: спецификация, техническое задание, юнит-тесты, код, прогон тестов в Docker-песочнице и ревью вторым агентом. Навыки привязаны к возможностям, а не к конкретным MCP, и подключаются в проект симлинками через инсталлер, поэтому правка навыка применяется во всех проектах. Навыки ведутся на русском, а в проекты ставится автоматически синхронизируемое английское зеркало.

Для кого. Для 1С-разработчиков и команд, которые хотят выстроить повторяемый процесс разработки с несколькими агентами.

Подходит, если

  • Нужно поручать агентам задачи по 1С от спецификации до протестированного кода
  • Нужно одинаково настроить навыки и правила для нескольких проектов 1С
  • Нужно ревью решений второй моделью, например через Codex

Не подходит, если

  • Нужна разовая помощь с отдельной обработкой без настройки инфраструктуры
  • Нет возможности развернуть песочницу и MCP-серверы

Пример запроса к агенту

Добавь в конфигурацию документ Заявка на закупку с проведением по регистру остатков, начни со спецификации и тестов

Ограничения

Полный цикл требует песочницы на Docker, серверной части 1С, PostgreSQL и Apache, а также набора MCP-серверов из docs/info/mcp.md. Автор отмечает, что не все скрипты кроссплатформенны, мультиагентный режим не опробован, работа с GUI через Vanessa не доделана. Часть документации в docs/specs-and-analisys может быть неактуальна.

Как отключить. Запустите python tools/install.py из каталога фреймворка и выберите деинсталляцию для проекта. Это удалит симлинки, не затрагивая исходники.

Проверка безопасности

  • Предполагает автономную работу агентов с кодом и базами в Docker-песочнице
  • Требует установки нескольких сторонних MCP-серверов
  • Инсталлятор создает симлинки в каталогах проекта и IDE

Коротко о README

README описывает фреймворк агентной разработки для 1С BSL с модульной установкой навыков, правил, сабагентов и воркфлоу через симлинки. Основа инфраструктуры: клиентская песочница и виртуальная машина для серверных служб из отдельного репозитория 1c-ai-sandbox-client-server. Рабочий процесс начинается с правила framework-bootstrap и воркфлоу full-cycle и orchestrator. Проект принимает только открытые и бесплатные решения. Лицензия MIT.

SKILL.md

---
name: framework-bootstrap
description: "На старте или компакте загрузить профиль оркестратора"
alwaysApply: true
---
# 1C BSL Agent Development Framework

Это фреймворк агентной разработки для 1С BSL. Минимальный always-on ориентир + портативный
кросс-харнес мост, поднимающий роль Lead/оркестратора в главном потоке. Детальный роутинг и манинг
оркестрации живут в **профиле оркестратора** (`framework/subagents/orchestrator.md`), а не здесь.

## Само-промотирующий стаб (главный поток)

```
- Если ты САБАГЕНТ (системный промпт явно называет роль: analyst / architect / developer-code /
  developer-tests / scenario-author / scenario-coder / tester / reviewer / explorer / debugger) →
  это правило НЕ для тебя. ВЫХОД.

- Если тело манинга оркестратора СЕЙЧАС в контексте → ты — Lead. Действуй по нему: классифицируй задачу → выбери цикл (short/full) → дальше по профилю.

- Иначе → ПРОЧИТАЙ СЕЙЧАС framework/subagents/orchestrator.md, затем действуй как Lead.
```

## Куда идти (короткая карта)

- Простая задача (баг в одном файле, < 20 строк, без новых фич, без новых объектов метаданных) →
  short-цикл: навык **`quick-fix`** (через Skill-тул).
- Средняя / сложная (новые фичи, несколько файлов, архитектура, новые объекты метаданных) →
  full-цикл: работа оркестратора по профилю + фазовая механика **`full-cycle`**.
- **Если сомневаешься** — трактуй как сложную (full).

## Инструменты

- Агент обнаруживает доступные инструменты динамически через MCP (`tools/list`) — не hardcode имена
  tool-ов

Частые вопросы

Почему в проекты ставятся английские файлы?

Кириллица занимает у LLM больше токенов, поэтому симлинки ведут на англоязычное зеркало, а редактируется русская версия.

Какие агенты использует автор?

Claude CLI для спецификаций и кода, Codex CLI как ревьюер, Cursor как оболочку.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний риск286,6 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск262 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Выбор редакции

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,3 тыс.
Выбор редакции

Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом

MCP-серверСредний риск62 тыс.