Набор правил, агентов, навыков и команд для эффективной разработки на платформе 1С:Предприятие 8.3 с использованием Cursor IDE и MCP-серверов.

• Назначение
• Структура каталога
• Установка
• MCP-серверы
• Агенты
• Правила
• Архитектура: агенты, субагенты, навыки
• SDD-интеграции
• Навыки
• Команды
• Сообщество

Данный репозиторий предназначен для размещения в папке .cursor вашего проекта 1С. Он содержит:

• Агенты и субагенты — специализированные AI-ассистенты для различных задач разработки, включая субагент для управления метаданными
• Правила — стандарты кодирования, антипаттерны, best practices для 1С
• Навыки — консолидированный диспетчерский навык для работы с метаданными и данными (17 доменов, 30+ PowerShell-инструментов, MCP-инструменты) и утилиты
• ��оманды — готовые сценарии для развёртывания и тестирования

Репозиторий ориентирован на использование MCP-серверов с vibecoding1c.ru.

.cursor/
├── agents/                    # AI-агенты и субагенты
│   ├── analytic.md           # Бизнес-аналитик (PRD, ТЗ, спецификации)
│   ├── architect.md          # Архитектор решений
│   ├── arch-reviewer.md      # Ревьюер архитектуры
│   ├── code-reviewer.md      # Ревьюер кода
│   ├── developer.md          # Разработчик
│   ├── doc-writer.md         # Технический писатель
│   ├── error-fixer.md        # Исправление ошибок
│   ├── metadata-manager.md   # Субагент: управление метаданными (NEW)
│   ├── performance-optimizer.md  # Оптимизация производительности
│   ├── planner.md            # Планировщик задач
│   ├── refactoring.md        # Рефакторинг
│   └── tester.md             # Тестирование
│
├── rules/                     # Правила и стандарты
│   ├── project_rules.mdc     # Основные правила проекта (всегда активны)
│   ├── user_rules.mdc        # Пользовательские правила (всегда активны)
│   ├── mcp-tools.mdc         # Справочник MCP-инструментов
│   ├── sdd-integrations.mdc  # Интеграции SDD-фреймворков
│   ├── anti-patterns.mdc     # Антипаттерны и оптимизации
│   ├── form_module_rules.mdc # Правила модулей форм (globs: **/Form.Module.bsl)
│   ├── forms_add.mdc         # Создание форм (интеграция с навыком 1c-metadata-manage)
│   ├── forms_events_add.mdc  # Обработчики событий форм (globs: **/Form.Module.bsl)
│   ├── integrations_add.mdc  # Интеграции
│   ├── refactor_add.mdc      # Рефакторинг
│   ├── template-search-mcp.mdc # Workflow: шаблоны кода и долговременная память (template-search-mcp)
│   └── getconfigfiles.mdc    # Выгрузка конфигурации
│
├── skills/                    # Специализированные навыки
│   ├── 1c-metadata-manage/    # Диспетчерский навык управления метаданными (CONSOLIDATED)
│   │   ├── SKILL.md          # Точка входа — маршрутизация по доменам
│   │   ├── docs/             # 17 документов по доменам (meta, form, SKD, MXL, role, data-tools, ...)
│   │   └── tools/            # 30+ PowerShell-инструментов со скриптами
│   ├── img-grid-analysis/     # Анализ изображений сеткой
│   ├── mermaid-diagrams/      # Создание Mermaid-диаграмм
│   └── powershell-windows/    # PowerShell на Windows
│
├── commands/                  # Команды для выполнения
│   ├── deploy_and_test.md    # Развёртывание и тестирование
│   └── getconfigfiles.md     # Выгрузка файлов конфигурации
│
└── README.md                  # Этот файл

1. Скопируйте содержимое репозитория в папку .cursor вашего проекта 1С
2. Настройте MCP-серверы согласно инструкциям на vibecoding1c.ru
3. Создайте файл infobasesettings.md в корне проекта с настройками вашей информационной базы:
   • Путь подключения к базе (например, C:\Users\...\InfoBase)
   • URL публикации для тестирования (например, http://localhost/MyBase/ru/)

Правила оптимизированы для работы с MCP-инструментами. Основные инструменты:

Агенты — это специализированные AI-ассистенты с предустановленными инструкциями для конкретных задач. Размещаются в .cursor/agents/ и вызываются через /имя-агента или автоматически по описанию задачи.

Все агенты ссылаются на @skills/powershell-windows/SKILL.md для корректной работы с PowerShell. Агенты, создающие диаграммы, дополнительно ссылаются на @skills/mermaid-diagrams/SKILL.md.

Субагенты — это агенты, которые запускаются в отдельном контекстном окне для изоляции сложных задач. Они наследуют все инструменты родительского агента (включая MCP) и работают автономно.

• Субагент — для сложных задач: создание, компиляция, многошаговые операции с метаданными (create → edit → validate → fix). Сохраняет контекстное окно основного агента чистым для написания кода.
• Напрямую — для простых запросов: проверка существования объекта, быстрый info-запрос, одиночная валидация.

Вызов: /metadata-manager создай справочник Контрагенты с реквизитами ИНН, КПП и управляемой формой

Правила — это .mdc-файлы с YAML-фронтматтером, размещаемые в .cursor/rules/. У каждого правила есть:

• description — когда Cursor должен предлагать это правило
• alwaysApply — применять ли автоматически к каждому запросу
• globs — шаблон файлов для автоматического подключения

• project_rules.mdc — основные правила разработки на 1С:

  • Персона, MCP-инструменты, стандарты кода, запросы, работа с данными через БСП
  • Оптимизация производительности, кэширование, транзакции
  • Метаданные: делегирование навыку 1c-metadata-manage и субагенту /metadata-manager

• user_rules.mdc — общие инженерные принципы:

  • Пошаговый подход, минимальные изменения, проверка перед изменениями

• template-search-mcp.mdc — workflow для MCP-сервера template-search-mcp:

  • Template-First: поиск шаблонов через templatesearch перед написанием нового кода
  • Сохранение проверенного кода в шаблоны через add_template
  • Долговременная память: recall перед принятием решений, remember для запоминания решений пользователя и исправлений ошибок

• mcp-tools.mdc — справочник всех MCP-инструментов с примерами использования
• sdd-integrations.mdc — интеграции с SDD-фреймворками (загружается по требованию, см. ниже)
• anti-patterns.mdc — каталог антипаттернов с примерами исправления:
  • Критические: запросы в цикле, точечная нотация, подзапросы в SELECT
  • Высокие: фильтр WHERE на виртуальных таблицах, лишние серверные вызовы
  • Средние: отсутствие кэширования, O(n²) алгоритмы, глубокая вложенность
• form_module_rules.mdc — правила для модулей форм (globs: **/Form.Module.bsl)
• forms_add.mdc — создание форм через MCP-инструменты + компиляция через навык 1c-metadata-manage
• forms_events_add.mdc — обработчики событий форм (globs: **/Form.Module.bsl)
• integrations_add.mdc — интеграции (Python-first подход для HTTP API)
• refactor_add.mdc — рефакторинг (top-down анализ, bottom-up рефакторинг)
• getconfigfiles.mdc — выгрузка объектов конфигурации

Схема взаимодействия компонентов:

Пользователь
    │
    ├── Вызов агента (/developer, /architect, /planner, ...)
    │       │
    │       ├── Правила (alwaysApply: true) загружены автоматически
    │       ├── Правила (контекстные) подключаются по globs / description
    │       ├── Навыки-утилиты подключаются по задаче (mermaid, powershell)
    │       │
    │       └── Сложная метаданные-задача?
    │               │
    │               ├── ДА → Делегирование субагенту /metadata-manager
    │               │         │
    │               │         ├── Читает SKILL.md навыка 1c-metadata-manage
    │               │         ├── Определяет домен(ы) задачи
    │               │         ├── Читает доменные docs/ и выполняет tools/scripts/
    │               │         ├── Валидирует результат
    │               │         └── Возвращает отчёт основному агенту
    │               │
    │               └── НЕТ → Агент выполняет задачу напрямую
    │
    └── Прямой вызов субагента (/metadata-manager ...)
            └── Работает автономно в отдельном контекстном окне

• Изоляция контекста: документация по метаданным (~4 200 строк / ~230 КБ) загружается в отдельное окно и не вытесняет код пользователя из контекста основного агента
• Параллелизм: можно запустить несколько субагентов одновременно (например, "создай справочник" + "создай регистр")
• Фокус: субагент загружает ВСЕ нужные документы без давления контекста
• Изоляция ошибок: цикл validate → fix → re-validate остаётся внутри субагента

Субагенты — это .md-файлы с YAML-фронтматтером в .cursor/agents/:

---
name: my-subagent
description: "Когда использовать этого субагента"
model: inherit
---

# Инструкции для субагента
...

Подробности: Cursor Subagents Docs

Все агенты поддерживают опциональную интеграцию с SDD-фреймворками, если они присутствуют в проекте. Подробности см. в rules/sdd-integrations.mdc.

Навыки — это углублённые руководства по специфическим темам. Каждый навык содержит пошаговые инструкции, скрипты и паттерны для конкретной области. Размещаются в .cursor/skills/.

Архитектурное решение: Все навыки для работы с метаданными 1С консолидированы в один диспетчерский навык 1c-metadata-manage. Это сокращает потребление токенов в системном промпте: вместо ~40 отдельных описаний навыков загружается одно, а документация по конкретному домену подгружается только при необходимости.

Единая точка входа для операций с метаданными 1С и взаимодействия с живой базой данных. Содержит:

• SKILL.md — маршрутизация: определяет домен задачи → выбирает режим выполнения (напрямую или через субагент /metadata-manager)
• docs/ — 17 доменных документов с пошаговыми инструкциями
• tools/ — 30+ PowerShell-инструментов со скриптами

Команды для развёртывания и тестирования:

1. Загрузка конфигурации — загрузка из файлов в информационную базу
2. Обновление БД — обновление структуры базы данных
3. Тестирование — открытие веб-клиента для проверки

Выгрузка объектов конфигурации из информационной базы в файлы для редактирования.

1. Всегда используйте MCP-инструменты — templatesearch перед написанием кода, search_metadata для проверки метаданных, docsearch для документации
2. Избегайте антипаттернов — запросы в циклах, точечная нотация, избыточные серверные вызовы
3. Используйте БСП — ОбщегоНазначения, СтроковыеФункцииКлиентСервер и другие модули
4. Проводите самопроверку — syntaxcheck после написания кода, внутреннее ревью
5. Пишите код на русском языке — переменные, комментарии, имена процедур

• Основные обсуждения: t.me/comol_it_does_matter
• Дополнительные материалы: t.me/yellow_ai_vibe
• MCP-серверы: vibecoding1c.ru

Делитесь своими правилами, агентами и навыками — присылайте pull request!

Репозиторий обновляется в процессе использования.