CodeAlive & 1С - CodeAlive

Эта страница написана по-русски: аудитория разработки на 1С:Предприятие русскоязычная, а ключевая проблема страницы — терминологическая — существует именно в русских формулировках. Остальная документация CodeAlive — на английском.

Функция специализированной индексации метаданных 1С сейчас находится в работе. Чтобы записаться в лист ожидания, напишите на support@codealive.ai. До запуска этой функции XML-описания объектов можно исследовать как обычные файлы с помощью grep_search и read_file.

Для кого эта страница

Вы разрабатываете на 1С:Предприятие 8 (язык BSL), храните выгрузку конфигурации или расширения в git-репозитории (1C:EDT-проект либо выгрузка из Конфигуратора) и подключили этот репозиторий к CodeAlive. Настройка агентов (Claude Code, Cursor, Codex) — та же, что описана на страницах интеграций; здесь — только 1С-специфика, которую нужно добавить поверх.

Главное: два разных значения слова «метаданные»

В 1С и в CodeAlive термин «метаданные» (metadata) означает разные вещи, и агент, работающий с 1С-проектом, обязан это различать — иначе он будет вызывать не тот инструмент.

	«Метаданные» в 1С	Artifact metadata в CodeAlive
Что это	Объекты конфигурации: справочники, документы, регистры (сведений, накопления, бухгалтерии, расчёта), планы видов характеристик, перечисления, общие модули, формы, роли	Технические характеристики проиндексированного кода: язык, размер, число строк, когнитивная сложность функций, связи вызовов
Где живёт	Структура конфигурации; в репозитории — XML-описания объектов	Индекс CodeAlive, построенный по файлам репозитория
Каким инструментом исследовать	`semantic_search` / `grep_search` / `read_file` по XML- и BSL-файлам выгрузки	`query_artifact_metadata` (+ `get_artifact_query_schema`)

Инструмент CodeAlive query_artifact_metadata не возвращает метаданные конфигурации 1С. Запрос агента «покажи метаданные документа РеализацияТоваровУслуг» должен превращаться в поиск по XML-описанию объекта (grep_search / read_file), а не в вызов query_artifact_metadata. Обратное тоже верно: вопрос «какие самые сложные функции в проекте?» — это как раз query_artifact_metadata.

Как формулировать запросы для 1С-кода

Правила те же, что и для любого языка, плюс одна особенность: идентификаторы в 1С русские.

semantic_search — вопрос формулируется полным предложением на английском (так работает векторный поиск CodeAlive), но имена процедур, справочников, документов и регистров остаются по-русски вербатим:
How is document posting implemented in ДокументыСервер common module? Where are записи в регистр накопления ТоварыНаСкладах created?
grep_search — точные русские литералы и имена как есть: имена процедур (ПровестиДокумент), тексты сообщений об ошибках, имена событий, куски запросов на языке запросов 1С (ВЫБРАТЬ, ИЗ РегистрНакопления).
XML-описания объектов — тоже проиндексированы: grep_search по имени объекта (РеализацияТоваровУслуг) находит и его XML-описание (реквизиты, табличные части), и все использования в BSL-модулях.

Готовое правило для агента

Блок ниже добавляется к универсальному правилу CodeAlive из Instructing Coding Agents — в CLAUDE.md, AGENTS.md или .cursor/rules/codealive.mdc. Он написан по-английски, потому что системные инструкции агентов работают надёжнее на английском; русские термины оставлены вербатим.

AGENTS.md / CLAUDE.md — секция для 1С-проекта

## 1C:Enterprise (BSL) specifics

This repository is a 1C:Enterprise configuration dump (BSL modules + XML
object descriptions).

- The word "метаданные"/"metadata" is ambiguous here. In 1C it means
  configuration objects: справочники (catalogs), документы (documents),
  регистры (registers), перечисления (enums), общие модули (common modules),
  forms, roles. CodeAlive's `query_artifact_metadata` tool does NOT return
  those — it returns code metrics (lines, complexity, languages).
  - "Show metadata of документ X" → search the object's XML description with
    CodeAlive `grep_search` / `read_file`, NOT `query_artifact_metadata`.
  - "Which functions are the most complex?" → that IS `query_artifact_metadata`.
- `semantic_search` questions are full English sentences, but keep Russian
  identifiers verbatim: procedure names (ПровестиДокумент), catalog and
  register names (ТоварыНаСкладах), module names (ДокументыСервер).
- Use `grep_search` for exact Russian literals: procedure names, error
  message texts, 1C query language fragments (ВЫБРАТЬ, ИЗ РегистрНакопления).
- Object XML descriptions are indexed too: to understand an object's
  structure (реквизиты, табличные части, измерения, ресурсы), grep its name
  and read the XML before reading module code.

Совместимость с ai_rules_1c

Если вы используете comol/ai_rules_1c — переносимый набор правил и субагентов для vibecoding в 1С (Cursor, Claude Code, Codex, OpenCode, Kilo Code) — CodeAlive дополняет его, а не конкурирует с ним:

ai_rules_1c задаёт дисциплину разработки (стандарты кода, формы, СКД, регистры, расширения) и MCP-first-поиск через специализированные 1С-инструменты; CodeAlive добавляет кросс-репозиторный семантический поиск и граф вызовов по проиндексированной выгрузке.
Правило CodeAlive из этой страницы кладите в USER-RULES.md (файл пользовательских правил, который установщик ai_rules_1c не перезаписывает), а не в генерируемый им AGENTS.md.
В их правиле mcp-first-search.md описана цепочка приоритетов поиска с fallback на Grep — при совместном использовании включите CodeAlive semantic_search/grep_search в эту цепочку до fallback-шага.

Связанные страницы

Instructing Coding Agents

Универсальное правило CodeAlive, к которому добавляется 1С-секция

MCP Overview

Подключение CodeAlive к агентам и список инструментов

Cursor

Настройка Cursor и обход встроенного codebase_search

Claude Code

Настройка Claude Code и CLAUDE.md

​Для кого эта страница

​Главное: два разных значения слова «метаданные»

​Как формулировать запросы для 1С-кода

​Готовое правило для агента

​Совместимость с ai_rules_1c

​Связанные страницы

Instructing Coding Agents

MCP Overview

Cursor

Claude Code

Для кого эта страница

Главное: два разных значения слова «метаданные»

Как формулировать запросы для 1С-кода

Готовое правило для агента

Совместимость с ai_rules_1c

Связанные страницы