Инструменты по категориям
Навык 1c-batch запускает установленный Конфигуратор 1С с параметрами подключения к файловой или серверной базе. Его скрипты выгружают конфигурацию и расширения в XML либо бинарные файлы и загружают их обратно; src/cf и src/cfe_* используются как локальные каталоги исходников. Для чтения структуры живой конфигурации правило mcp-1c направляет агента к отдельно установленному и опубликованному серверу 1c_mcp.
Собственные команды по конфигурации
dump-config, load-config | выгрузка XML и загрузка полной конфигурации либо выбранных файлов. |
|---|---|
dump-cf, load-cf | выгрузка и загрузка бинарного файла конфигурации .cf. |
dump-extension, load-extension | выгрузка XML и загрузка расширения. |
dump-cfe, load-cfe | выгрузка и загрузка бинарного файла расширения .cfe. |
/setup-project | настраивает паспорт проекта, каталоги исходников, подключение внешнего MCP и параметры Конфигуратора. |
Сильная сторона
пакетный обмен исходниками между проектом и базой с возможностью частичной XML-загрузки конфигурации. Ограничения: нет собственного структурного поиска или точечного MCP-редактора метаданных; загрузка может обновить конфигурацию базы, если явно не пропустить этот шаг.
Claude Code работает с локальными исходниками проекта в src/cf, src/cfe_* и при необходимости с эталоном поставщика в src/cf_vendor. Навыки extract-to-extension и config-modification задают порядок анализа и переноса изменений; скрипт extract-diff.py сравнивает конкретный BSL/XML-объект с эталоном. Живой код базы шаблон самостоятельно не индексирует и не ищет.
Собственные средства по коду
extract-diff.py <путь> [--vendor-root ...] [--work-root ...] [--no-body] | группирует различия BSL по процедурам и кратко описывает XML-изменения объекта. |
|---|---|
1c-code-explorer | роль для исследования локальных исходников средствами Claude Code. |
extract-to-extension | навык переноса существующей доработки в расширение с возвратом типового объекта к эталону. |
Сильная сторона
предметный отчёт о расхождениях с поставщиком перед переносом доработки; явный режим --restore может вернуть BSL-модуль к эталону с проверкой состояния в Git. Ограничения: нужна эталонная версия исходников; нет собственного поиска по всему коду, call graph, LSP и MCP tool для чтения модуля.
form-work — навык Claude Code с паттернами управляемых форм: директивы клиента и сервера, обработчики, программные реквизиты и элементы, динамические списки и асинхронные диалоги. Агент применяет эти инструкции к локальным исходникам проекта в src/cf или src/cfe_*; установленный Конфигуратор может загрузить изменённую конфигурацию скриптом load-config или load-extension.
Средства по формам
form-work | инструкции и примеры разработки модуля управляемой формы. |
|---|---|
config-modification | оформление перехватчиков и изменений формы в расширении. |
extract-diff.py --review-extension <каталог> --vendor-root <эталон> | ревизия форм расширения относительно поставщика, включая проверку основы заимствованной формы. |
load-config, load-extension | загрузка изменённых XML-исходников через Конфигуратор. |
Сильная сторона
детальные паттерны формы связаны с правилами проекта, сравнением с эталоном и сценарием загрузки результата. Ограничения: нет отдельного конструктора элементов, валидатора XML или прямого EDT host; для ревизии расширения нужны его исходники и соответствующий эталон поставщика.
Навык skd-design задаёт последовательность проектирования наборов данных, полей, ресурсов, параметров, вариантов и настроек СКД. Он просит агента выбрать доступный структурный анализатор, редактор и валидатор; сам набор их не поставляет. query-writing отвечает за текст запроса набора данных. Для внешнего отчёта пакетные скрипты могут собрать или разобрать .erf через установленный Конфигуратор.
Средства по СКД и отчётам
skd-design | инструкция по проектированию, изменению и ревью модели отчёта. |
|---|---|
query-writing | правила составления и проверки текста запроса СКД. |
build-epf, dump-epf | сборка и разборка внешних обработок и отчётов .epf/.erf. |
Сильная сторона
отделяет проектирование модели СКД от редактирования артефакта и предусматривает проверку результата на данных. Ограничения: нет собственного MCP-инструмента анализа СКД, генератора схемы, точечного редактора или валидатора; для сборки ERF/EPF нужна установленная 1С.
Роль 1c-code-reviewer читает локальные изменения проекта и сверяет их с правилами BSL, требованиями задачи и проектным паспортом. 1c-code-simplifier ищет избыточную сложность. Проверка выполняется агентом в Claude Code; у шаблона нет собственного статического анализатора или MCP tool диагностики. Для текста стандарта и расшифровки кода диагностики инструкции направляют агента к внешнему v8std.
Средства проверки кода
1c-code-reviewer | роль ревьюера по единому чек-листу. |
|---|---|
1c-code-simplifier | роль упрощения кода после реализации. |
1c-rules | локальные правила написания BSL с пометками происхождения. |
/commit | команда анализа diff и оформления логически связанных изменений в Git. |
Сильная сторона
требования и критерии ревью закреплены в одном наборе правил. Ограничения: синтаксическая диагностика, машинный статический анализ и автоматические исправления зависят от внешних инструментов, если они подключены; набор сам их не выполняет.
odata_query.sh читает живую базу через её опубликованный стандартный OData HTTP-сервис. Скрипт формирует GET-запросы с Basic Auth; источник — сама база, а не XML-выгрузка. Навыки query-writing и mcp-1c направляют агента к отдельно подключённому 1c_mcp для проверки и выполнения текста запроса 1С. Свой сервис запросов шаблон не публикует.
Собственные средства по данным и запросам
odata_query.sh -e <сущность> | читает сущности OData; поддерживает $filter, $select, $top, $skip, $orderby, $expand, $count и чтение $metadata. |
|---|---|
1c-odata | инструкция по выбору сущности, чтению схемы и использованию скрипта. |
query-writing | правила написания и оптимизации запроса 1С; выполнение требует другого инструмента. |
mcp-1c | инструкция по работе с инструментами внешнего MCP-сервера базы, включая validate_query и execute_query. |
Сильные стороны
реальное чтение опубликованных OData-сущностей с фильтрацией и пагинацией; отдельный протокол проверки запроса перед выполнением через MCP. Ограничения: OData-скрипт не выполняет текст запроса 1С и не записывает данные; нужен опубликованный сервис и учётная запись. Для кириллических URL на Windows скрипту требуется Node.js.
Каталог .claude устанавливается в проект 1С как набор инструкций Claude Code. При настройке /setup-project заполняются паспорт проекта, подключение к опубликованной базе и параметры скриптов. Свои MCP tools набор не регистрирует: обращения к живой базе и к стандартам выполняются через отдельно подключённые 1c_mcp и v8std.
Навыки (все 16):
| Навык | Назначение |
|---|---|
1c-batch | Выгрузка/загрузка конфигураций и расширений, сборка и разборка EPF/ERF через Конфигуратор |
1c-feature-dev | Полный цикл доработки с исследованием, планом, реализацией и ревью |
1c-integrations | HTTP/JSON/XML-интеграции на BSL |
1c-odata | Чтение опубликованных данных базы через локальный OData-скрипт |
brainstorm | Проработка требований и вариантов решения |
config-modification | Правила изменения типового кода и расширений |
enterprisedata-exch | Разбор и доработка обменов EnterpriseData через БСП |
errors | Исключения, транзакции и блокировки |
extract-to-extension | Перенос существующей доработки в расширение после сравнения с эталоном |
form-work | Паттерны управляемых форм и обработчиков |
mcp-1c | Порядок работы с внешним MCP-сервером базы 1С |
obj-lifecycle | Обработчики записи, проведения и удаления объектов |
query-writing | Написание и оптимизация запросов 1С |
skd-design | Проектирование и проверка модели СКД |
ssl-ext-commands | Подключаемые команды БСП |
use-bsp | Переиспользование API и механизмов БСП |
Роли
1c-code-architect, 1c-code-explorer, 1c-code-writer, 1c-code-reviewer, 1c-code-simplifier, 1c-code-documenter. Команды: /setup-project, /commit, /doc-obj-analyst, /doc-obj-dev, /doc-obj-user, /metaprompt-create, /metaprompt-improve, /new-brief, /new-plan. Три правила задают нормы BSL, общий порядок работы и приоритет источников через MCP.
Исполняемый слой дают скрипты 1c-batch, extract-diff.py и odata_query.sh; остальные навыки маршрутизируют действия агента и содержат примеры. Для пакетных операций нужны Windows, PowerShell и установленная 1С; для внешнего MCP — отдельно опубликованная база с 1c_mcp.
Правила BSL поставляются как локальный текст в каталоге проекта и автоматически применяются Claude Code к BSL, OneScript и некоторым файлам метаданных. Каждая норма помечена происхождением: стандарт, факт платформы, рекомендация или правило проекта. Отдельное правило mcp направляет агента к опубликованной базе для фактов о конфигурации и к внешнему серверу v8std для полного текста стандартов и диагностик.
Собственные материалы по методологии
1c-rules | нормы BSL и общий чек-лист разработки. |
|---|---|
mcp | порядок проверки фактов через базу, исходники и стандарты. |
use-bsp | паттерны применения БСП. |
errors | обработка исключений, транзакций и блокировок. |
obj-lifecycle | порядок обработчиков записи и проведения. |
config-modification | правила доработки типового кода и расширений. |
Сильная сторона
агент видит происхождение нормы и применяет единый чек-лист в разработке и ревью. Ограничения: шаблон не хранит полные тексты стандартов и не реализует собственного поискового MCP; для актуального текста и кодов диагностик требуется отдельно подключённый v8std.
Что учитывать
1c_mcp и v8std. Пакетные операции выполняют локальные PowerShell-скрипты (есть .bat-варианты), чтение OData — Bash-скрипт с curl.1c_mcp и опубликованную базу; для стандартов — внешний v8std. Для OData — опубликованный OData-сервис, Bash, curl и учётную запись; Node.js нужен для корректного кодирования кириллицы в URL на Windows. extract-diff.py требует Python и эталонные исходники поставщика.extract-diff.py сравнивает локальные BSL/XML-исходники с эталоном поставщика и отдельно проверяет формы расширения; с явным --restore может вернуть BSL-файлы к эталону, предварительно проверяя возможность отката через Git. Пакетные скрипты запускают Конфигуратор и могут загружать изменения в базу. odata_query.sh выполняет чтение по HTTP GET с фильтрацией и пагинацией. Инструменты 1c_mcp и v8std принадлежат внешним проектам и становятся доступны только после их подключения.