Набор правил, агентов, навыков и MCP-конфигураций для эффективной разработки на платформе 1С:Предприятие 8.3 с использованием Claude Code и MCP-серверов.
- Назначение
- Структура каталога
- Установка
- MCP-серверы и инструменты ревью
- Агенты
- Правила
- Загрузка правил по профилям
- SDD-интеграции (Spec-Driven Development)
- Навыки
- Ключевые принципы
- Истоки
- Участие
Данный репозиторий предназначен для размещения в корне вашего проекта 1С. Он содержит:
- CLAUDE.md - главный (англоязычный) файл инструкций Claude Code;
rus_CLAUDE.md- зеркальный русский перевод - Агенты - специализированные AI-подагенты для различных задач разработки
- Правила - стандарты кодирования, антипаттерны, best practices для 1С
- Навыки - углубленные знания и инструменты для специфических задач
- MCP-конфигурация - подключение к серверам исследования кода, справке платформы и диагностике BSL
CLAUDE.md # Главный (EN) файл инструкций Claude Code
rus_CLAUDE.md # Русское зеркало CLAUDE.md (DO NOT EDIT DIRECTLY)
profile-loading.md # Документация по механике загрузки правил (для людей)
.mcp.json.example # Шаблон конфигурации MCP-серверов
.dev.env.example # Шаблон параметров проекта (PREFIX, COMPANY, DEVELOPER и др.)
.v8-project.json.example # Шаблон реестра информационных баз (платформа 8.3, базы, алиасы)
.gitignore # Исключает .dev.env, .v8-project.json, локальные настройки Claude из git
.claude/
├── agents/ # AI-подагенты для различных ролей
│ ├── analytic.md # Бизнес-аналитик (PRD, ТЗ, спецификации)
│ ├── architect.md # Архитектор решений
│ ├── arch-reviewer.md # Ревьюер архитектуры
│ ├── code-reviewer.md # Ревьюер кода
│ ├── developer.md # Разработчик
│ ├── doc-writer.md # Технический писатель
│ ├── error-fixer.md # Исправление ошибок
│ ├── metadata-manager.md # Управление метаданными
│ ├── performance-optimizer.md # Оптимизация производительности
│ ├── planner.md # Планировщик задач
│ ├── refactoring.md # Рефакторинг
│ └── tester.md # Тестирование
│
├── skills_instructions.md # Реестр и dispatch-таблица всех локальных навыков (SSOT)
├── 1c-metadata-manage.md # Карта знаний по домену метаданных (проектные правила, routing)
├── profiles.json # Карта профилей загрузки правил (committed)
├── profile.local.json.example # Шаблон локального выбора профиля; копируется в profile.local.json (gitignored)
├── settings.json # Регистрация SessionStart-хука
├── hooks/
│ └── session-start-load-profile.ps1 # Хук: инжектит каталог профилей в контекст сессии
├── rules/ # Auto-loaded core (минимум, грузится при каждой сессии)
│ ├── user_rules.md # Общие принципы + правила предложения профиля и команды управления загрузкой
│ ├── typography.md # Repo-wide правило типографики (em-dash / en-dash / yo)
│ ├── dev-standards-forms.md # Стандарты модулей форм (path-scoped: **/Form.Module.bsl)
│ ├── form_module_rules.md # Правила модулей форм (path-scoped: **/Form.Module.bsl)
│ └── forms_events_add.md # Обработчики событий форм (path-scoped: **/Form.Module.bsl)
├── lib/ # On-demand standards (грузятся через профиль или после предложения от агента)
│ ├── project_rules.md # Coding standards: запросы, доступ к данным, производительность
│ ├── dev-standards-core.md # Стандарты: .dev.env, стиль, именование, документирование
│ ├── dev-standards-architecture.md # Стандарты: архитектура, расширения, code smells
│ ├── anti-patterns.md # Антипаттерны (критические, высокие, средние) с фиксами
│ ├── mcp-tools.md # Справочник MCP-инструментов и инструментов ревью
│ ├── powershell-windows.md # Правила PowerShell на Windows
│ └── sdd-integrations.md # Интеграции SDD-фреймворков
│
└── skills/ # Плоский набор upstream-скиллов (полный список - в skills_instructions.md)
-
Клонируйте этот репозиторий в произвольный каталог:
git clone https://github.com/Dach-Coin/claude_rules_1c.git
-
Скопируйте в корень исходных файлов вашего проекта 1С (формат CF / EDT - туда, где лежат
Configuration.xmlили EDT-проект):- Папку
.claude/целиком (правила, агенты, скиллы, хук, реестр профилей). CLAUDE.md(главный файл инструкций Claude Code) иrus_CLAUDE.md(русское зеркало)..mcp.json.example→ переименуйте в.mcp.json, пропишите MCP-серверы..dev.env.example→ скопируйте в.dev.env, заполнитеPREFIX,COMPANY,DEVELOPER,PLATFORM_VERSIONи т. д..v8-project.json.example→ скопируйте в.v8-project.json, пропишите путь к платформе 1С (v8path) и список ваших ИБ. Описание полей и интерактивное добавление баз - через скиллdb-list(см..claude/skills_instructions.md, раздел «Базы данных»)..gitignore(или объедините с вашим - он исключает локальные.dev.env,.v8-project.jsonи пользовательские настройки Claude).
- Папку
-
Подключите внешние компоненты:
- MCP-серверы
rlm-tools-bslи1c-syntax(см. ссылки в разделе MCP-серверы). - Плагин диагностики
bsl-language-server.
- MCP-серверы
-
(Опционально) Настройте профиль загрузки правил под ваш типичный класс задач: скопируйте
.claude/profile.local.json.exampleв.claude/profile.local.jsonи укажите{"active": "<profile>"}. Подробнее -profile-loading.md.
| Файл / папка | В git проекта 1С? | Назначение |
|---|---|---|
.claude/ (все, кроме *.local.*) |
да | Правила, агенты, скиллы, хук - общие для команды |
CLAUDE.md, rus_CLAUDE.md |
да | Инструкции Claude Code |
.mcp.json |
да (или нет, по политике команды) | Конфигурация MCP-серверов |
.dev.env |
нет (gitignore) | Параметры проекта и комментарии модификаций |
.v8-project.json |
нет (gitignore) | Реестр ИБ - у каждого разработчика свои пути |
.claude/profile.local.json |
нет (gitignore) | Локальный выбор профиля - у каждого свой |
После установки откройте проект в Claude Code - SessionStart-хук автоматически инжектит каталог профилей в контекст, агент готов к работе.
Полная справка - в .claude/lib/mcp-tools.md. Краткий обзор:
| Источник | Репозиторий | Назначение |
|---|---|---|
| rlm-tools-bsl | Dach-Coin/rlm-tools-bsl | Исследование кода 1С через Python-песочницу (rlm_start, rlm_execute, rlm_end, rlm_projects, rlm_index). Поиск паттернов, вызовов, парсинг XML-метаданных |
| 1c-syntax | Starik2005/1c-syntax-mcp | Справка по платформе 1С: поиск встроенных функций, подробная справка, автодополнение, валидация сигнатуры (search_syntax, get_function_info, suggest_completion, validate_syntax) |
| bsl-language-server | 1c-syntax/claude-code-bsl-lsp | LSP-интеграция BSL Language Server: диагностика, go-to-definition, find-references, rename после написания BSL-кода |
В .claude/lib/mcp-tools.md#capability-boundaries описаны осознанные деградации: cross-project curated-шаблоны, семантический поиск БСП, NL-поиск метаданных, автоматический анализ логики/производительности, help-topics и семантический поиск кода полностью недоступны - используем компенсирующие подходы.
Агенты - специализированные подагенты Claude Code с предустановленными инструкциями, моделями и инструментами. В каждом агенте есть явное правило: пользователю отвечать на русском, оркестратору допустим английский.
| Агент | Модель | Описание |
|---|---|---|
| 1c-developer | opus | Основной агент для написания кода. Следует стандартам, использует MCP-инструменты, проводит самопроверку |
| 1c-architect | opus | Проектирование архитектуры модификаций. Анализ паттернов, trade-off analysis, диаграммы |
| 1c-analytic | opus | Бизнес-анализ и документация. PRD, ТЗ, спецификации без написания кода |
| Агент | Модель | Описание |
|---|---|---|
| 1c-code-reviewer | sonnet | Ревью кода с confidence scoring. Проверка на антипаттерны, безопасность, производительность |
| 1c-arch-reviewer | sonnet | Ревью архитектурных решений |
| 1c-error-fixer | haiku | Исправление ошибок и проблем. Быстрая модель для минимальных точечных правок |
| 1c-refactoring | opus | Рефакторинг с сохранением функциональности |
| 1c-performance-optimizer | opus | Оптимизация производительности |
| Агент | Модель | Описание |
|---|---|---|
| 1c-doc-writer | opus | Написание технической документации |
| 1c-planner | opus | Планирование задач и декомпозиция |
| 1c-tester | opus | Разработка тестов, развертывание и проверка |
| 1c-metadata-manager | opus | Управление метаданными 1С (формы, макеты, роли, расширения) |
Правила разделены на три слоя: auto-core (грузится автоматически при каждой сессии), профильные (грузятся по выбранному профилю или после предложения агента под задачу) и path-scoped (грузятся при работе с файлами модулей форм).
Грузятся автоматически в каждой сессии Claude Code:
- user_rules.md - принципы работы + правила предложения профиля и команды управления загрузкой правил
- typography.md - repo-wide правило типографики (нет em-dash, en-dash, yo)
Грузятся через .claude/profiles.json + .claude/profile.local.json (SessionStart-хук инжектит каталог; агент Read'ает файлы активного профиля). Если профиль не задан - после первого промпта агент сам предлагает 1-3 ранжированных варианта и грузит файлы по подтверждению юзера. Эвристика ранжирования - в .claude/rules/user_rules.md.
- project_rules.md - coding standards: запросы, доступ к данным, производительность, форматирование
- dev-standards-core.md - параметры
.dev.env, стиль кода, комментарии модификаций, именование, документирование - dev-standards-architecture.md - архитектурные паттерны, расширения, платформенные стандарты, code smells
- anti-patterns.md - каталог антипаттернов (критические, высокие, средние) с примерами исправления
- mcp-tools.md - справочник по выбору MCP-инструментов с таблицей маппинга задач
- powershell-windows.md - правила PowerShell-скриптинга на Windows
- sdd-integrations.md - интеграции с SDD-фреймворками (Memory Bank, OpenSpec, Spec Kit, TaskMaster)
Состав каждого профиля и его описание - в .claude/profiles.json. Локальный выбор - в .claude/profile.local.json (gitignored; копируется из .claude/profile.local.json.example, настраивается каждым разработчиком под свою задачу).
Грузятся автоматически при открытии файла модуля формы:
- dev-standards-forms.md - структура модулей форм, правила модификации
- form_module_rules.md - клиент-серверное взаимодействие, директивы компиляции
- forms_events_add.md - добавление обработчиков событий форм
Подробное описание механики загрузки (3-слойная модель, SessionStart-хук, переключение профиля локально и в чате, добавление новых профилей, поведение при /compact / /resume, под-капотные особенности WinPS/UTF-8) - в profile-loading.md.
Кратко:
.claude/profiles.json(committed) - каталог профилей, источник истины..claude/profile.local.json(gitignored) - локальный выбор активного профиля; шаблон в.claude/profile.local.json.example..claude/hooks/session-start-load-profile.ps1- SessionStart-хук, инжектит каталог профилей в контекст сессии на матчерахstartup/resume/clear/compact.- Команды управления загрузкой в чате (
загрузи профиль X,добавь файл Y,какие правила сейчас активны) - см. документ выше.
Все агенты поддерживают опциональную интеграцию с SDD-фреймворками, если они присутствуют в проекте. Подробности см. в .claude/lib/sdd-integrations.md.
| Фреймворк | Тип | Описание | Обнаружение |
|---|---|---|---|
| Claude Auto Memory | Файловый | Управление контекстом через MEMORY.md и тематические файлы памяти |
Файл CLAUDE.md (всегда доступно в Claude Code) |
| OpenSpec | Файловый | Спецификации и предложения изменений | Папка openspec/specs/ |
| spec-kit (GitHub) | Файловый | Управление архитектурными ограничениями | Файлы spec.md, constitution.md |
| TaskMaster | MCP-сервер | AI-управление задачами | MCP user-task-master-ai |
Полный реестр локальных навыков и dispatch-правила - в .claude/skills_instructions.md. Там перечислены все upstream-скиллы, сгруппированные по доменам (метаданные, формы, СКД, MXL, роли, CF, CFE, подсистемы и командный интерфейс, EPF/ERF, универсальные, базы данных, веб-публикация и тестирование, утилиты).
Для задач по структуре метаданных 1С дополнительно читайте .claude/1c-metadata-manage.md - там собраны проектные правила, грабли и таблица «домен -> скилл».
- Используй правильный слой: MCP-инструменты - инспекция; навыки - мутация; агенты - оркестрация.
- Перед написанием кода - исследуй конфигурацию через
rlm-tools-bsl(внутриконфигурационные паттерны заменяют утраченную базу curated-шаблонов). - Избегай антипаттернов - запросы в циклах, точечная нотация, избыточные серверные вызовы.
- Используй БСП (см. раздел «SSL / БСП» в
.claude/1c-metadata-manage.md). - Диагностика BSL после любого редактирования - через
bsl-language-server(лимит - 3 итерации по стилю). - Пиши код на русском - переменные, комментарии, имена процедур.
Набор локальных скиллов - blanket-импорт из Nikolay-Shirokov/cc-1c-skills@f5dd677. Проектная доработка поверх upstream - параметризация PLATFORM_PATH в PS1-скриптах и собственная карта знаний .claude/1c-metadata-manage.md.
Делитесь своими правилами, агентами и навыками - присылайте pull request!
Репозиторий обновляется в процессе использования.