AI-EDT MCP Tools
MCP-сервер ai-edt дает прямой доступ к семантическому индексу EDT (BM model), платформенной
документации, проверкам, отладке и конструкторам метаданных. Работает через живой экземпляр EDT. Semantic-
операции (ссылки, определения, иерархия вызовов, структура модуля) идут по BM-модели и AST, а не по
текстовому совпадению; текстовый и regex-поиск в каталоге тоже есть (code_search operation=text_search).
Каталог инструментов вынесен в references/ - читай нужный файл по ситуации, а не весь набор.
Навык написан под AI-EDT - MCP-сервер работает плагином
внутри запущенной 1C:EDT (update site: https://desko77.github.io/ai-edt/). Весь каталог в
references/ описывает именно его: больше сотни операций, свернутых в фасады с маршрутизацией
через operation=.
Если подключен ДРУГОЙ MCP-плагин для EDT, этот каталог к нему неприменим: там свой набор
инструментов, свои имена и фасадов может не быть вовсе - вызов вида
diagnostics operation=get_project_errors вернет ошибку. Ключ сервера тоже свой. Порядок в этом
случае: взять фактические имена из tools/list сессии и работать по документации своего плагина;
общие принципы навыка (что проверять после правки, чего не подменять ручной правкой файлов)
остаются в силе.
When to Use
- Анализ и правка BSL: модули, методы, ссылки, вызовы, рефакторинг.
- Метаданные: чтение, создание, изменение, удаление, переименование с каскадом.
- Управляемые формы: структура, скриншот из WYSIWYG-редактора, правка без ручного XML.
- Обычные формы EDT (
Form.oform): ordinary_forms для раскладки, создания, импорта и
inspect_layout; модуль доступен стандартным инструментам модулей. Аргументы -
references/ordinary-forms.md.
- Запросы 1С: валидация синтаксиса и семантики до запуска.
- Ошибки проекта, обновление ИБ, юнит-тесты YAxUnit, отладка и профилирование.
Для BSL и метаданных 1С этот сервер приоритетнее Grep/Read и точнее любого текстового поиска.
Когда НЕ использовать
- 1С 7.7 (
.1s, .ert, 1Cv7.MD) - скил 1c77-dev и сервер 1c77-metadata: инструменты EDT к 7.7
неприменимы.
- Проект в формате Конфигуратора без EDT-проекта - для XML-выгрузки есть отдельные
скилы
1c-* (cf/epf/erf). Обычные формы EDT обслуживает ordinary_forms.
- Данные живой базы вне отладочной сессии - скил
1c-mcp-toolkit по HTTP.
- EDT не запущена - инструменты недоступны; сообщить пользователю, а не переходить на ручную правку
файлов проекта.
Prerequisites
get_edt_version - проба. Не ответил - корректный вывод "ai-edt недоступен", а НЕ "EDT не запущена": та же
картина бывает при недоступном MCP-сервере, зависшей очереди вызовов и несовместимом плагине. При ошибке
связи или timeout self_status НЕ вызывать - он на том же сервере; он полезен только когда сервер отвечает,
но операция не проходит. Разбор случаев и что делать в каждом - rules/mcp-tool-priority.md, раздел "Когда
инструменты недоступны". Коротко: анализировать без MCP можно, писать в проект вслепую - нельзя.
Ключевые фасады - точки входа
Фасад заменяет набор родственных standalone-инструментов: одна точка входа, действие выбирается параметром
operation (у отладчика - action). У большинства есть встроенная справка: operation=help, детали
конкретной операции - operation=help topic=<операция>. find=<слова> ищет по справке фасада и
называет тему, по которой открыть раздел целиком.
| Фасад |
Когда брать |
code_search |
исследовать код и модель: поиск, ссылки, определения, иерархия вызовов, символы. Только чтение |
edit_metadata |
создавать и менять метаданные и формы; массовые правки - batch=true |
diagnostics |
ошибки проекта, сводки, перевалидация, проверка перед экспортом |
launch_debugger |
отладка целиком: запуск и attach, точки останова, шаги, переменные, evaluate, профилирование |
project_admin |
проекты, конфигурации, подсистемы, resync на диск, перезапуск EDT |
infobase_admin |
ИБ и запуск: приложения, базы из списка EDT, создание и удаление ИБ, учетные данные, обновление, выгрузка и загрузка всей базы как .dt, sync_control |
config_io |
импорт и экспорт конфигурации и отдельных артефактов, включая конфигурацию и расширение из самой базы |
insights |
метрики, графы зависимостей, сравнение конфигураций, анализ влияния |
security_audit |
роли, RLS, чувствительные данные |
docs_lookup |
документация платформы и встроенная справка объектов |
workspace_marks |
теги, объекты по тегам, закладки, задачи |
cluster_admin |
читать и изменять иерархию кластеров навигатора: коллекции, вложенные папки, размещение объектов |
tag_admin |
создание, изменение, удаление, назначение и снятие меток; dryRun и доступ под пресетами - раздел tag_admin в references/facades.md |
git |
репозиторий проекта внутри EDT: статус, ветки, история, коммит названных файлов, переход по веткам, изменения файла и его возврат из коммита, точка восстановления перед объединением и ее удаление (записи гасятся как git_commit / git_checkout / git_revert_file / git_create_merge_restore_point / git_delete_merge_restore_point) |
yaxunit_tests |
юнит-тесты YAxUnit; installYaxunit=true устанавливает движок и подтверждает оба флага безопасности снятыми, если не yaxunitUnsafeMode=false |
Данных информационной базы у плагина нет. browse_data, execute_query и фасад data_access из него
удалены - звать их бесполезно. Запрос или чтение данных живой базы - скил 1c-mcp-toolkit (обработка по HTTP). Отладка отдает только состояние исполнения текущего кадра
(get_variables, evaluate_expression), а не таблицы базы.
Одно исключение - журнал регистрации (с 0.2.27): infobase_admin operation=read_event_log читает журнал
ФАЙЛОВОЙ базы прямо из плагина - кто входил, что проводилось, какие обновления платформа отвергла.
Отбор по from / to / event / user / severity; severity сравнивается точно и принимает буквы
I, W, E, N и полные имена важности. Исключение событий через excludeEvents - раздел
infobase_admin в references/facades.md. Это не запрос к данным: журнал лежит файлами рядом с базой.
Серверная база и однофайловый формат 1Cv8.lgd отвечают именованным отказом, а не пустым списком.
Конфигурация и изменения самой базы (0.2.56): config_io operation=export_database_configuration /
export_database_extension выгружают конфигурацию или расширение из базы в .cf / .cfe;
sync_control operation=retrieve_database_changes подтягивает сделанные в базе изменения в проект -
направление, обратное update_database; export_database_snapshot / restore_database_snapshot выгружают
и загружают всю базу одним .dt, загрузка не начинается без резервной копии и помечает хранимую копию ConfigDumpInfo.xml: инкрементальное
update_database отказывает до rebuild_dump_info. Доводы и отказы -
Напарник 1.0.8 (с 0.2.57): мост naparnik принимает 1С:Напарник 1.0.8 наряду с 1.0.7; status
отвечает supportedVersion: "1.0.7, 1.0.8", ответы ask не изменились.
references/facades.md.
Состав операций каждого фасада - references/facades.md, здесь только маршрут: перечни операций намеренно
не дублируются, иначе два списка расходятся.
Не фасады, вызываются напрямую: vanessa (сценарии Vanessa Automation, снимок формы работающей 1С -
доводы в каталоге инструментов), self_status, конструкторы dcs_workshop (СКД),
mxl_workshop (табличные документы), xdto_workshop (XDTO-пакеты), extension_workshop (расширения и
заимствование), external_object_workshop (внешние обработки и отчеты), external_data_source_workshop.
Часть standalone-инструментов поглощена фасадами и остается backward-compat алиасами (примеры):
get_project_errors / clean_project / revalidate_objects -> diagnostics; debug_launch /
set_breakpoint / step / resume -> launch_debugger; get_tags / get_objects_by_tags /
get_bookmarks / get_tasks -> workspace_marks.
Под пресетом Canonical поглощенные имена скрыты из tools/list (оставаясь вызываемыми), поэтому
канонический вызов - через фасад: diagnostics operation=get_project_errors, launch_debugger action=launch.
Ниже и в references имена операций пишутся короткой формой для узнаваемости.
Поглощены НЕ все. Самостоятельными остаются, в частности, write_module_source, validate_query,
get_edt_version, read_module_source, read_method_source, get_module_structure, list_modules,
ai_context, diff_module, get_form_structure, get_form_screenshot, code_review. Список не
исчерпывающий - сверяться с tools/list и references/facades.md. Записи BSL в code_search нет вовсе:
он только читает.
Навигация по references
| Нужно |
Файл |
Операции фасадов, baseline диагностик, типы и умолчания создания, графы, /health, статусы задач MCP |
references/facades.md |
Чтение и запись BSL: допустимые пути, unchanged, поиск неиспользуемых методов |
references/code-and-model.md |
| Создание и правка метаданных, формы, макеты, конструкторы |
references/metadata-forms-constructors.md |
| Обычные формы EDT, контейнер Form.oform, раскладка, модуль и импорт |
references/ordinary-forms.md |
ИБ, запуск и отладка, deadline и сверка имен YAxUnit, отсутствующий featurePath Vanessa |
references/infobase-debug-tests.md |
| Ошибки проекта, валидация, метрики, графы, безопасность |
references/diagnostics-analysis-security.md |
| Проект и воркспейс, метки, задачи, композитные агентские инструменты, пресеты видимости |
references/project-tags-agent-helpers.md |
| Готовый порядок вызовов под конкретную задачу |
references/workflows.md |
| Теги ошибок, троттлинг, грабли, большие конфигурации, sync_control |
references/gotchas-and-errors.md |
Каталог в references/ - снимок docs AI-EDT на ревизии 4fb31770 (28.07.2026), 118 имен сверены с
реестром групп ToolCategory.java. Снимок отстает от рабочего дерева форка: там уже появляются
инструменты, которых нет ни в реестре групп, ни в docs (например find_dead_code), а число 118 полноты не
доказывает.
Инструмент не нашелся в каталоге - не считать, что его нет, и не уходить в ручной обход. Порядок поиска:
tools/list текущей сессии (там актуальный набор с учетом пресета) -> operation=help у профильного фасада
(каталог операций) -> edit_metadata operation=help topic=availability (что доступно на этом runtime).
self_status для этого НЕ годится: он показывает состояние сервера, служб EDT и очереди, а не каталог
инструментов. Каталог устарел - пересобрать снимок из docs проекта, а не дописывать по памяти: именно так в
скил попадали инструменты из старых версий.
Критические запреты и проверки
Полный список обязательных проверок с лимитами - rules/mcp-tool-priority.md, раздел "Обязательные
проверки" (единственный источник). Здесь только то, без чего скил применять нельзя.
- BSL пишется через
write_module_source, а не Edit/Write по .bsl: иначе EDT не увидит правку до
refresh, теряется авто-валидация и подсчет строк. Перед первой записью в модуль -
rules/edt-bsl-write-safety.md: там безопасные режимы (replaceMethod, replaceLines с
expectedText, вставки insertBefore / insertAfter) и почему голый replace затирает модуль.
- Формы правятся form-операциями
edit_metadata, а не ручным XML в .form.
validate_query после каждого написанного или измененного запроса, не копя до конца; для СКД -
dcsMode=true.
validate_for_export перед любой записью конфигурации в ИБ и перед сборкой артефактов, включая
неявную запись у yaxunit_tests. Findings блокируют операцию.
Остальные обязательные проверки (ask_1c_ai с обязательной верификацией его замечаний, порядок
revalidate_objects -> get_project_errors, лимиты итераций, поведение при отказе сервера) не
перечисляются здесь во избежание расхождений - они в rules/mcp-tool-priority.md, раздел "Обязательные
проверки", пункты 1-6.
Экономия контекста
ai_context с target=<FQN> и depth=standard - один вызов вместо metadata + modules + structure.
Замер размеров ответов и предел maxMethods - references/code-and-model.md, раздел ai_context.
get_module_structure -> read_method_source вместо чтения модуля целиком: работает и на модулях 25k+
строк, отдает точные границы методов дешево по токенам.
- Крупные карты (
list_modules, каталог FQN, структура большого модуля) кэшировать один раз в
gitignored-файл проекта, а не перезапрашивать.
- Тяжелые выборки уводить в субагента, чтобы сырье не оседало в основном контексте. Детали и запреты -
references/gotchas-and-errors.md.
Обработка ошибок
Не ретраить вслепую: сигналы Pending/runKey, propertyMismatch, requiresCascadeForms,
*ApiNotFound, BSL model is not available требуют разных действий. Полная таблица -
references/gotchas-and-errors.md. Лимиты повторов и правило остановки (сменить подход, а не бросить
задачу) заданы в rules/mcp-tool-priority.md, раздел "Троттлинг и ошибки" - там единственный источник.
Подтвержденный дефект плагина или пожелание к нему - issue в Desko77/ai-edt через скил report-issue:
воспроизведение, поиск дубликата, обезличенный черновик, отправка только с согласия пользователя. Не дефект
плагина: EDT не запущена или проект не загружен, *ApiNotFound и dcsFactoryMethodNotFound (в запущенной
EDT нет нужного API), ошибка в конфигурации или в самом вызове. Дефект платформы 1С, другого плагина EDT
или MCP-клиента - назвать продукт и куда он принимает сообщения; вопрос без дефекта - тема Telegram
https://t.me/AI_EDT_1c/23.
1---2name: ai-edt-tools3description: "EDT-based 1C:Enterprise (1С:Предприятие 8.3+) development via the EDT MCP server - BSL code analysis and editing, metadata inspection and construction, module navigation, query validation, managed forms, error checking, debugging, infobase update. Use when the project is an EDT workspace: 1C/BSL modules, .mdo metadata, 1C queries, managed forms. Not for 1C 7.7 (.1s/.ert/1Cv7.MD) and not for Configurator-format sources without an EDT project - those have their own skills."4metadata:5 source: https://skillmd.com/skills/desko77/ai-edt-tools6---78# AI-EDT MCP Tools910MCP-сервер **ai-edt** дает прямой доступ к семантическому индексу EDT (BM model), платформенной11документации, проверкам, отладке и конструкторам метаданных. Работает через живой экземпляр EDT. Semantic-12операции (ссылки, определения, иерархия вызовов, структура модуля) идут по BM-модели и AST, а не по13текстовому совпадению; текстовый и regex-поиск в каталоге тоже есть (`code_search operation=text_search`).1415Каталог инструментов вынесен в `references/` - читай нужный файл по ситуации, а не весь набор.1617> **Навык написан под [AI-EDT](https://github.com/Desko77/ai-edt)** - MCP-сервер работает плагином18> внутри запущенной 1C:EDT (update site: https://desko77.github.io/ai-edt/). Весь каталог в19> `references/` описывает именно его: больше сотни операций, свернутых в **фасады** с маршрутизацией20> через `operation=`.21>22> Если подключен ДРУГОЙ MCP-плагин для EDT, этот каталог к нему неприменим: там свой набор23> инструментов, свои имена и фасадов может не быть вовсе - вызов вида24> `diagnostics operation=get_project_errors` вернет ошибку. Ключ сервера тоже свой. Порядок в этом25> случае: взять фактические имена из `tools/list` сессии и работать по документации своего плагина;26> общие принципы навыка (что проверять после правки, чего не подменять ручной правкой файлов)27> остаются в силе.2829## When to Use3031- Анализ и правка BSL: модули, методы, ссылки, вызовы, рефакторинг.32- Метаданные: чтение, создание, изменение, удаление, переименование с каскадом.33- Управляемые формы: структура, скриншот из WYSIWYG-редактора, правка без ручного XML.34- Обычные формы EDT (`Form.oform`): `ordinary_forms` для раскладки, создания, импорта и35 `inspect_layout`; модуль доступен стандартным инструментам модулей. Аргументы -36 `references/ordinary-forms.md`.37- Запросы 1С: валидация синтаксиса и семантики до запуска.38- Ошибки проекта, обновление ИБ, юнит-тесты YAxUnit, отладка и профилирование.3940Для BSL и метаданных 1С этот сервер приоритетнее Grep/Read и точнее любого текстового поиска.4142## Когда НЕ использовать4344- **1С 7.7** (`.1s`, `.ert`, `1Cv7.MD`) - скил `1c77-dev` и сервер `1c77-metadata`: инструменты EDT к 7.745 неприменимы.46- **Проект в формате Конфигуратора без EDT-проекта** - для XML-выгрузки есть отдельные47 скилы `1c-*` (cf/epf/erf). Обычные формы EDT обслуживает `ordinary_forms`.48- **Данные живой базы вне отладочной сессии** - скил `1c-mcp-toolkit` по HTTP.49- **EDT не запущена** - инструменты недоступны; сообщить пользователю, а не переходить на ручную правку50 файлов проекта.5152## Prerequisites5354`get_edt_version` - проба. Не ответил - корректный вывод "ai-edt недоступен", а НЕ "EDT не запущена": та же55картина бывает при недоступном MCP-сервере, зависшей очереди вызовов и несовместимом плагине. При ошибке56связи или timeout `self_status` НЕ вызывать - он на том же сервере; он полезен только когда сервер отвечает,57но операция не проходит. Разбор случаев и что делать в каждом - `rules/mcp-tool-priority.md`, раздел "Когда58инструменты недоступны". Коротко: анализировать без MCP можно, писать в проект вслепую - нельзя.5960## Ключевые фасады - точки входа6162Фасад заменяет набор родственных standalone-инструментов: одна точка входа, действие выбирается параметром63`operation` (у отладчика - `action`). У большинства есть встроенная справка: `operation=help`, детали64конкретной операции - `operation=help topic=<операция>`. `find=<слова>` ищет по справке фасада и65называет тему, по которой открыть раздел целиком.6667| Фасад | Когда брать |68|---|---|69| `code_search` | исследовать код и модель: поиск, ссылки, определения, иерархия вызовов, символы. Только чтение |70| `edit_metadata` | создавать и менять метаданные и формы; массовые правки - `batch=true` |71| `diagnostics` | ошибки проекта, сводки, перевалидация, проверка перед экспортом |72| `launch_debugger` | отладка целиком: запуск и attach, точки останова, шаги, переменные, evaluate, профилирование |73| `project_admin` | проекты, конфигурации, подсистемы, resync на диск, перезапуск EDT |74| `infobase_admin` | ИБ и запуск: приложения, базы из списка EDT, создание и удаление ИБ, учетные данные, обновление, выгрузка и загрузка всей базы как `.dt`, `sync_control` |75| `config_io` | импорт и экспорт конфигурации и отдельных артефактов, включая конфигурацию и расширение из самой базы |76| `insights` | метрики, графы зависимостей, сравнение конфигураций, анализ влияния |77| `security_audit` | роли, RLS, чувствительные данные |78| `docs_lookup` | документация платформы и встроенная справка объектов |79| `workspace_marks` | теги, объекты по тегам, закладки, задачи |80| `cluster_admin` | читать и изменять иерархию кластеров навигатора: коллекции, вложенные папки, размещение объектов |81| `tag_admin` | создание, изменение, удаление, назначение и снятие меток; `dryRun` и доступ под пресетами - раздел `tag_admin` в `references/facades.md` |82| `git` | репозиторий проекта внутри EDT: статус, ветки, история, коммит названных файлов, переход по веткам, изменения файла и его возврат из коммита, точка восстановления перед объединением и ее удаление (записи гасятся как `git_commit` / `git_checkout` / `git_revert_file` / `git_create_merge_restore_point` / `git_delete_merge_restore_point`) |83| `yaxunit_tests` | юнит-тесты YAxUnit; `installYaxunit=true` устанавливает движок и подтверждает оба флага безопасности снятыми, если не `yaxunitUnsafeMode=false` |8485**Данных информационной базы у плагина нет.** `browse_data`, `execute_query` и фасад `data_access` из него86удалены - звать их бесполезно. Запрос или чтение данных живой базы - скил `1c-mcp-toolkit` (обработка по HTTP). Отладка отдает только состояние исполнения текущего кадра87(`get_variables`, `evaluate_expression`), а не таблицы базы.8889**Одно исключение - журнал регистрации** (с 0.2.27): `infobase_admin operation=read_event_log` читает журнал90ФАЙЛОВОЙ базы прямо из плагина - кто входил, что проводилось, какие обновления платформа отвергла.91Отбор по `from` / `to` / `event` / `user` / `severity`; `severity` сравнивается точно и принимает буквы92`I`, `W`, `E`, `N` и полные имена важности. Исключение событий через `excludeEvents` - раздел93`infobase_admin` в `references/facades.md`. Это не запрос к данным: журнал лежит файлами рядом с базой.94Серверная база и однофайловый формат `1Cv8.lgd` отвечают именованным отказом, а не пустым списком.9596**Конфигурация и изменения самой базы** (0.2.56): `config_io operation=export_database_configuration` /97`export_database_extension` выгружают конфигурацию или расширение из базы в `.cf` / `.cfe`;98`sync_control operation=retrieve_database_changes` подтягивает сделанные в базе изменения в проект -99направление, обратное `update_database`; `export_database_snapshot` / `restore_database_snapshot` выгружают100и загружают всю базу одним `.dt`, загрузка не начинается без резервной копии и помечает хранимую копию `ConfigDumpInfo.xml`: инкрементальное101`update_database` отказывает до `rebuild_dump_info`. Доводы и отказы -102103**Напарник 1.0.8** (с 0.2.57): мост `naparnik` принимает 1С:Напарник 1.0.8 наряду с 1.0.7; `status`104отвечает `supportedVersion: "1.0.7, 1.0.8"`, ответы `ask` не изменились.105`references/facades.md`.106107Состав операций каждого фасада - `references/facades.md`, здесь только маршрут: перечни операций намеренно108не дублируются, иначе два списка расходятся.109110Не фасады, вызываются напрямую: `vanessa` (сценарии Vanessa Automation, снимок формы работающей 1С -111доводы в каталоге инструментов), `self_status`, конструкторы `dcs_workshop` (СКД),112`mxl_workshop` (табличные документы), `xdto_workshop` (XDTO-пакеты), `extension_workshop` (расширения и113заимствование), `external_object_workshop` (внешние обработки и отчеты), `external_data_source_workshop`.114115Часть standalone-инструментов поглощена фасадами и остается backward-compat алиасами (примеры):116`get_project_errors` / `clean_project` / `revalidate_objects` -> `diagnostics`; `debug_launch` /117`set_breakpoint` / `step` / `resume` -> `launch_debugger`; `get_tags` / `get_objects_by_tags` /118`get_bookmarks` / `get_tasks` -> `workspace_marks`.119120**Под пресетом Canonical поглощенные имена скрыты из `tools/list`** (оставаясь вызываемыми), поэтому121канонический вызов - через фасад: `diagnostics operation=get_project_errors`, `launch_debugger action=launch`.122Ниже и в references имена операций пишутся короткой формой для узнаваемости.123124Поглощены НЕ все. Самостоятельными остаются, в частности, `write_module_source`, `validate_query`,125`get_edt_version`, `read_module_source`, `read_method_source`, `get_module_structure`, `list_modules`,126`ai_context`, `diff_module`, `get_form_structure`, `get_form_screenshot`, `code_review`. Список не127исчерпывающий - сверяться с `tools/list` и `references/facades.md`. Записи BSL в `code_search` нет вовсе:128он только читает.129130## Навигация по references131132| Нужно | Файл |133|---|---|134| Операции фасадов, baseline диагностик, типы и умолчания создания, графы, `/health`, статусы задач MCP | `references/facades.md` |135| Чтение и запись BSL: допустимые пути, `unchanged`, поиск неиспользуемых методов | `references/code-and-model.md` |136| Создание и правка метаданных, формы, макеты, конструкторы | `references/metadata-forms-constructors.md` |137| Обычные формы EDT, контейнер Form.oform, раскладка, модуль и импорт | `references/ordinary-forms.md` |138| ИБ, запуск и отладка, deadline и сверка имен YAxUnit, отсутствующий `featurePath` Vanessa | `references/infobase-debug-tests.md` |139| Ошибки проекта, валидация, метрики, графы, безопасность | `references/diagnostics-analysis-security.md` |140| Проект и воркспейс, метки, задачи, композитные агентские инструменты, пресеты видимости | `references/project-tags-agent-helpers.md` |141| Готовый порядок вызовов под конкретную задачу | `references/workflows.md` |142| Теги ошибок, троттлинг, грабли, большие конфигурации, sync_control | `references/gotchas-and-errors.md` |143144Каталог в `references/` - снимок docs AI-EDT на ревизии `4fb31770` (28.07.2026), 118 имен сверены с145реестром групп `ToolCategory.java`. **Снимок отстает от рабочего дерева форка**: там уже появляются146инструменты, которых нет ни в реестре групп, ни в docs (например `find_dead_code`), а число 118 полноты не147доказывает.148149Инструмент не нашелся в каталоге - не считать, что его нет, и не уходить в ручной обход. Порядок поиска:150`tools/list` текущей сессии (там актуальный набор с учетом пресета) -> `operation=help` у профильного фасада151(каталог операций) -> `edit_metadata operation=help topic=availability` (что доступно на этом runtime).152`self_status` для этого НЕ годится: он показывает состояние сервера, служб EDT и очереди, а не каталог153инструментов. Каталог устарел - пересобрать снимок из docs проекта, а не дописывать по памяти: именно так в154скил попадали инструменты из старых версий.155156## Критические запреты и проверки157158Полный список обязательных проверок с лимитами - `rules/mcp-tool-priority.md`, раздел "Обязательные159проверки" (единственный источник). Здесь только то, без чего скил применять нельзя.1601611. **BSL пишется через `write_module_source`**, а не Edit/Write по `.bsl`: иначе EDT не увидит правку до162 refresh, теряется авто-валидация и подсчет строк. Перед первой записью в модуль -163 `rules/edt-bsl-write-safety.md`: там безопасные режимы (`replaceMethod`, `replaceLines` с164 `expectedText`, вставки `insertBefore` / `insertAfter`) и почему голый `replace` затирает модуль.1652. **Формы правятся form-операциями `edit_metadata`**, а не ручным XML в `.form`.1663. **`validate_query` после каждого написанного или измененного запроса**, не копя до конца; для СКД -167 `dcsMode=true`.1684. **`validate_for_export` перед любой записью конфигурации в ИБ и перед сборкой артефактов**, включая169 неявную запись у `yaxunit_tests`. Findings блокируют операцию.170171Остальные обязательные проверки (`ask_1c_ai` с обязательной верификацией его замечаний, порядок172`revalidate_objects` -> `get_project_errors`, лимиты итераций, поведение при отказе сервера) не173перечисляются здесь во избежание расхождений - они в `rules/mcp-tool-priority.md`, раздел "Обязательные174проверки", пункты 1-6.175176## Экономия контекста177178- `ai_context` с `target=<FQN>` и `depth=standard` - один вызов вместо metadata + modules + structure.179 Замер размеров ответов и предел `maxMethods` - `references/code-and-model.md`, раздел `ai_context`.180- `get_module_structure` -> `read_method_source` вместо чтения модуля целиком: работает и на модулях 25k+181 строк, отдает точные границы методов дешево по токенам.182- Крупные карты (`list_modules`, каталог FQN, структура большого модуля) кэшировать один раз в183 gitignored-файл проекта, а не перезапрашивать.184- Тяжелые выборки уводить в субагента, чтобы сырье не оседало в основном контексте. Детали и запреты -185 `references/gotchas-and-errors.md`.186187## Обработка ошибок188189Не ретраить вслепую: сигналы `Pending`/`runKey`, `propertyMismatch`, `requiresCascadeForms`,190`*ApiNotFound`, `BSL model is not available` требуют разных действий. Полная таблица - 191`references/gotchas-and-errors.md`. Лимиты повторов и правило остановки (сменить подход, а не бросить192задачу) заданы в `rules/mcp-tool-priority.md`, раздел "Троттлинг и ошибки" - там единственный источник.193194Подтвержденный дефект плагина или пожелание к нему - issue в `Desko77/ai-edt` через скил `report-issue`:195воспроизведение, поиск дубликата, обезличенный черновик, отправка только с согласия пользователя. Не дефект196плагина: EDT не запущена или проект не загружен, `*ApiNotFound` и `dcsFactoryMethodNotFound` (в запущенной197EDT нет нужного API), ошибка в конфигурации или в самом вызове. Дефект платформы 1С, другого плагина EDT198или MCP-клиента - назвать продукт и куда он принимает сообщения; вопрос без дефекта - тема Telegram199`https://t.me/AI_EDT_1c/23`.