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

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

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

• Агенты — специализированные AI-ассистенты для различных задач разработки
• Правила — стандарты кодирования, антипаттерны, best practices для 1С
• Навыки — углублённые знания по специфическим темам (оптимизация запросов, работа с БСП)
• Команды — готовые сценарии для развёртывания и тестирования

Репозиторий ориентирован на использование 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        # Исправление ошибок
│   ├── performance-optimizer.md  # Оптимизация производительности
│   ├── planner.md            # Планировщик задач
│   ├── refactoring.md        # Рефакторинг
│   └── tester.md             # Тестирование
│
├── rules/                     # Правила и стандарты
│   ├── project_rules.mdc     # Основные правила проекта (всегда активны)
│   ├── user_rules.mdc        # Пользовательские правила (всегда активны)
│   ├── mcp-tools.mdc         # Справочник MCP-инструментов
│   ├── sdd-integrations.mdc  # Интеграции SDD-фреймворков (Memory Bank, OpenSpec, Spec Kit, TaskMaster)
│   ├── anti-patterns.mdc     # Антипаттерны и оптимизации
│   ├── form_module_rules.mdc # Правила модулей форм
│   ├── forms_add.mdc         # Создание форм
│   ├── forms_events_add.mdc  # Обработчики событий форм
│   ├── integrations_add.mdc  # Интеграции
│   ├── refactor_add.mdc      # Рефакторинг
│   └── getconfigfiles.mdc    # Выгрузка конфигурации
│
├── skills/                    # Специализированные навыки
│   ├── 1c-bsp-command/        # Добавление команд БСП
│   ├── 1c-bsp-registration/   # Регистрация в БСП
│   ├── 1c-epf-scaffold/       # Создание внешних обработок
│   ├── 1c-form-compile/       # Компиляция Form.xml из JSON DSL
│   ├── 1c-form-edit/          # Редактирование существующих форм
│   ├── 1c-form-info/          # Анализ структуры формы
│   ├── 1c-form-patterns/      # Паттерны проектирования форм
│   ├── 1c-form-scaffold/      # Создание/удаление управляемых форм
│   ├── 1c-form-validate/      # Валидация структуры формы
│   ├── 1c-help-manage/        # Управление встроенной справкой
│   ├── 1c-mxl-compile/        # Компиляция макетов из JSON DSL
│   ├── 1c-mxl-decompile/      # Декомпиляция макетов в JSON DSL
│   ├── 1c-mxl-info/           # Анализ структуры макетов
│   ├── 1c-mxl-validate/       # Валидация макетов
│   ├── 1c-platform-ops/       # Операции с платформой 1С
│   ├── 1c-query-optimization/  # Оптимизация запросов
│   ├── 1c-role-compile/       # Создание ролей
│   ├── 1c-role-info/          # Анализ прав ролей
│   ├── 1c-ssl-patterns/       # Паттерны работы с БСП
│   ├── 1c-template-manage/    # Управление макетами объектов
│   ├── 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-ассистенты с предустановленными инструкциями для конкретных задач.

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

  • Использование MCP-инструментов
  • Стандарты форматирования кода
  • Правила написания запросов
  • Работа с данными через БСП
  • Оптимизация производительности

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

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

• mcp-tools.mdc — справочник всех MCP-инструментов с примерами использования
• sdd-integrations.mdc — интеграции с SDD-фреймворками (загружается по требованию, см. ниже)
• anti-patterns.mdc — каталог антипаттернов с примерами исправления:
  • Критические: запросы в цикле, точечная нотация, подзапросы в SELECT
  • Высокие: фильтр WHERE на виртуальных таблицах, лишние серверные вызовы
  • Средние: отсутствие кэширования, O(n²) алгоритмы, глубокая вложенность
• form_module_rules.mdc — правила для модулей форм (клиент-серверное взаимодействие, директивы компиляции)

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

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

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

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!

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