meta-remove

name	meta-remove
description	Этот скилл MUST быть вызван когда пользователь просит удалить, убрать объект из конфигурации 1С. SHOULD также вызывать при очистке неиспользуемых объектов конфигурации. Do NOT использовать для модификации объекта — используй meta-edit; для удаления формы — используй form-remove.
argument-hint	<ConfigDir> -Object <Type.Name>
allowed-tools	["Bash","Read","Glob","AskUserQuestion"]

/meta-remove — удаление объекта метаданных

Безопасно удаляет объект из XML-выгрузки конфигурации. Перед удалением проверяет ссылки на объект в реквизитах, коде и других метаданных. Если ссылки найдены — удаление блокируется.

Использование

/meta-remove <ConfigDir> -Object <Type.Name>

Параметры

Параметр	Обязательный	Описание
ConfigDir	да	Корневая директория выгрузки (где Configuration.xml)
Object	да	Тип и имя объекта: Catalog.Товары, Document.Заказ и т.д.
DryRun	нет	Только показать что будет удалено, без изменений
KeepFiles	нет	Не удалять файлы, только дерегистрировать
Force	нет	Удалить несмотря на найденные ссылки

Команда

powershell.exe -NoProfile -File .claude/skills/meta-remove/scripts/meta-remove.ps1 -ConfigDir "<путь>" -Object "Catalog.Товары"

Что делает

1. Находит файлы объекта: {TypePlural}/{Name}.xml и {TypePlural}/{Name}/
2. Проверяет ссылки (блокирует при наличии, если нет -Force):
   • XML-типы в реквизитах других объектов: CatalogRef.Имя, DocumentRef.Имя и т.д.
   • BSL-код: Справочники.Имя, Catalogs.Имя, вызовы общих модулей
   • Журналы документов, подписки на события, определяемые типы
3. Удаляет из Configuration.xml: убирает из <ChildObjects>
4. Очищает подсистемы: рекурсивно удаляет из <Content>
5. Удаляет файлы: XML-файл и каталог объекта

Поддерживаемые типы

Catalog, Document, Enum, Constant, InformationRegister, AccumulationRegister, AccountingRegister, CalculationRegister, ChartOfAccounts, ChartOfCharacteristicTypes, ChartOfCalculationTypes, BusinessProcess, Task, ExchangePlan, DocumentJournal, Report, DataProcessor, CommonModule, ScheduledJob, EventSubscription, HTTPService, WebService, DefinedType, Role, Subsystem, CommonForm, CommonTemplate, CommonPicture, CommonAttribute, SessionParameter, FunctionalOption, FunctionalOptionsParameter, Sequence, FilterCriterion, SettingsStorage, XDTOPackage, WSReference, StyleItem, Language

Вывод (объект без ссылок)

=== meta-remove: Catalog.Устаревший ===

[FOUND] Catalogs/Устаревший.xml
[FOUND] Catalogs/Устаревший/ (8 files)

--- Reference check ---
[OK]    No references found

--- Configuration.xml ---
[OK]    Removed <Catalog>Устаревший</Catalog> from ChildObjects
[OK]    Configuration.xml saved

--- Subsystems ---
[OK]    Removed from subsystem 'Справочники'

--- Files ---
[OK]    Deleted directory: Catalogs/Устаревший/
[OK]    Deleted file: Catalogs/Устаревший.xml

=== Done: 4 actions performed (1 subsystem references removed) ===

Вывод (объект со ссылками — блокировка)

=== meta-remove: Catalog.Валюты ===

[FOUND] Catalogs/Валюты.xml
[FOUND] Catalogs/Валюты/ (4 files)

--- Reference check ---
[WARN]  Found 3 reference(s) to Catalog.Валюты:

        Documents/СчетНаОплату.xml
          pattern: CatalogRef.Валюты
        InformationRegisters/КурсыВалют.xml
          pattern: CatalogRef.Валюты
        CommonModules/РаботаСВалютами/Ext/Module.bsl
          pattern: Справочники.Валюты

[ERROR] Cannot remove: object has 3 reference(s).
        Use -Force to remove anyway, or fix references first.

Код возврата: 0 = успешно, 1 = ошибки или найдены ссылки.

Проверяемые ссылки

Категория	Паттерны поиска
XML-типы реквизитов	CatalogRef.Name, DocumentRef.Name, EnumRef.Name и др.
BSL-код (рус.)	Справочники.Name, Документы.Name, Перечисления.Name и др.
BSL-код (англ.)	Catalogs.Name, Documents.Name, Enums.Name и др.
Общие модули	Name. (вызовы методов), <Handler>Name., <MethodName>Name.

Ссылки из Configuration.xml, ConfigDumpInfo.xml и подсистем НЕ считаются блокирующими — они очищаются автоматически.

Примеры

# Проверка ссылок + dry run
... -ConfigDir C:\WS\tasks\cfsrc\acc_8.3.24 -Object "Catalog.Устаревший" -DryRun

# Удалить объект без ссылок
... -ConfigDir C:\WS\tasks\cfsrc\acc_8.3.24 -Object "Catalog.Устаревший"

# Принудительно удалить несмотря на ссылки
... -ConfigDir C:\WS\tasks\cfsrc\acc_8.3.24 -Object "Catalog.Устаревший" -Force

# Только дерегистрировать (файлы оставить)
... -ConfigDir C:\WS\tasks\cfsrc\acc_8.3.24 -Object "Report.Старый" -KeepFiles

# Удалить общий модуль
... -ConfigDir src -Object "CommonModule.МойМодуль"

Когда использовать

• Рефакторинг: удаление неиспользуемых объектов
• Очистка: удаление временных/тестовых объектов
• Перенос: удаление объекта перед пересозданием с другой структурой