agentleFS
anymasoftanymasoft/1c-ai/.claude/skills/inspect/SKILL.md

inspect

Skill0 starsChanged 4 months agoMITView on GitHub

Этот скилл MUST быть вызван для анализа и инспекции любого объекта 1С из XML-выгрузки: конфигурация (cf-info), объект метаданных (meta-info), управляемая форма (form-info), схема компоновки данных СКД (skd-info), макет табличного документа MXL (mxl-info), подсистема (subsystem-info), роль и права (role-info). SHOULD вызывать как подготовительный шаг перед любой модификацией объекта. Do NOT использовать для модификации — для изменений используй соответствующие edit/compile скиллы.

15 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

/inspect — Инспекция объектов 1С

Единый скилл для анализа и инспекции любого объекта 1С из XML-выгрузки. Заменяет отдельные cf-info, meta-info, form-info, skd-info, mxl-info, subsystem-info, role-info.


1. Конфигурация (Configuration.xml)

Читает Configuration.xml из выгрузки конфигурации и выводит компактное описание структуры.

Параметры

ПараметрОписание
ConfigPathПуть к Configuration.xml или каталогу выгрузки
Modeoverview (default), brief, full
Limit / OffsetПагинация (по умолчанию 150 строк)
OutFileЗаписать результат в файл (UTF-8 BOM)
powershell.exe -NoProfile -File .claude/skills/inspect/scripts/cf-info.ps1 -ConfigPath "<путь>"

Режимы

РежимЧто показывает
overview (default)Заголовок + ключевые свойства + таблица счётчиков объектов по типам
briefОдна строка: Имя — "Синоним" vВерсия | N объектов | совместимость
fullВсе свойства по категориям + полный список ChildObjects + DefaultRoles + мобильные функциональности

Примеры

# Обзор конфигурации
... -ConfigPath upload/cfempty

# Краткая сводка
... -ConfigPath upload/acc_8.3.24 -Mode brief

# Полная информация с пагинацией
... -ConfigPath upload/acc_8.3.24 -Mode full -Limit 50 -Offset 100

2. Объект метаданных (XML-выгрузка)

Читает XML объекта метаданных и выводит компактное описание: реквизиты, табличные части, формы, движения, типы.

Параметры

ПараметрОписание
ObjectPathПуть к XML-файлу объекта или каталогу (авто-резолв <name>/<name>.xml)
Modeoverview (default), brief, full
NameDrill-down по имени элемента (реквизит, ТЧ, значение перечисления, шаблон URL, операция)
Limit / OffsetПагинация (по умолчанию 150 строк)
OutFileЗаписать результат в файл (UTF-8 BOM)
powershell.exe -NoProfile -File .claude/skills/inspect/scripts/meta-info.ps1 -ObjectPath "<путь>"

Режимы

РежимЧто показывает
overview (default)Заголовок + ключевые свойства + структура без раскрытия деталей
briefВсё одной-двумя строками: имена полей, счётчики
fullВсё раскрыто: колонки ТЧ, список источников подписки, движения, формы

-Name — drill-down: раскрыть конкретный элемент (ТЧ, реквизит, шаблон URL, операцию веб-сервиса).

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

Ссылочные: Справочник, Документ, Перечисление, Бизнес-процесс, Задача, План обмена, План счетов, ПВХ, ПВР Регистры: Регистр сведений, Регистр накопления, Регистр бухгалтерии, Регистр расчёта Сервисные: Отчёт, Обработка, HTTP-сервис, Веб-сервис, Общий модуль, Регламентное задание, Подписка на событие Прочие: Константа, Журнал документов, Определяемый тип

Примеры

# Справочник — overview
... -ObjectPath Catalogs/Валюты/Валюты.xml

# Документ — полная сводка с колонками ТЧ, движениями, формами
... -ObjectPath Documents/АвансовыйОтчет/АвансовыйОтчет.xml -Mode full

# Регистр сведений — краткая сводка
... -ObjectPath InformationRegisters/КурсыВалют/КурсыВалют.xml -Mode brief

# Drill-down в ТЧ документа
... -ObjectPath Documents/АвансовыйОтчет/АвансовыйОтчет.xml -Name Товары

# HTTP-сервис — drill-down в шаблон URL
... -ObjectPath HTTPServices/ExternalAPI/ExternalAPI.xml -Name АктуальныеЗадачи

# Веб-сервис — drill-down в операцию
... -ObjectPath WebServices/EnterpriseDataUpload_1_0_1_1/EnterpriseDataUpload_1_0_1_1.xml -Name TestConnection

3. Управляемая форма (Form.xml)

Читает Form.xml и выводит компактную сводку: дерево элементов, реквизиты с типами, команды, события. Заменяет необходимость читать тысячи строк XML.

Параметры

ПараметрОбязательныйПо умолчаниюОписание
FormPathда—Путь к файлу Form.xml
Limitнет150Макс. строк вывода
Offsetнет0Пропустить N строк (для пагинации)
powershell.exe -NoProfile -File .claude/skills/inspect/scripts/form-info.ps1 -FormPath "<путь к Form.xml>"

С пагинацией:

... -FormPath "<путь>" -Offset 150

Чтение вывода

Elements — компактное дерево UI-элементов с типами, привязками к данным, флагами и событиями:

Elements:
  ├─ [Group:AH] ГруппаШапка
  │  ├─ [Input] Организация -> Объект.Организация {OnChange}
  │  └─ [Input] Договор -> Объект.Договор [visible:false] {StartChoice}
  ├─ [Table] Товары -> Объект.Товары
  │  └─ [Input] Номенклатура -> Объект.Товары.Номенклатура {OnChange}
  └─ [Pages] Страницы
     ├─ [Page] Основное (5 items)
     └─ [Page] Печать (2 items)

Сокращения типов: [Group:V/H/AH/AV], [Input], [Check], [Label], [Table], [Button], [Pages], [Page], [Popup] Флаги: [visible:false], [enabled:false], [ro], ,collapse

Attributes — реквизиты формы (тип, ValueTable с колонками, DynamicList → MainTable). Parameters — параметры формы с ключевым параметром (key). Commands — Имя -> Обработчик [Сочетание]. Events — обработчики событий формы.


4. СКД — Схема компоновки данных (Template.xml)

Читает Template.xml схемы компоновки данных (СКД/DCS) и выводит компактную сводку. Подробная справка по режимам — в references/skd-modes-reference.md.

Параметры

ПараметрОписание
TemplatePathПуть к Template.xml или каталогу макета (авто-резолв в Ext/Template.xml)
ModeРежим анализа (по умолчанию overview)
NameИмя набора (query), поля (fields/calculated/resources/trace), варианта (variant), группировки/поля (templates)
BatchНомер пакета запроса, 0 = все (только query)
Limit / OffsetПагинация (по умолчанию 150 строк)
OutFileЗаписать результат в файл (UTF-8 BOM)
powershell.exe -NoProfile -File .claude/skills/inspect/scripts/skd-info.ps1 -TemplatePath "<путь>"

С указанием режима:

... -Mode query -Name НоменклатураСЦенами
... -Mode query -Name ДанныеТ13 -Batch 3
... -Mode fields -Name КадастроваяСтоимость
... -Mode trace -Name "Коэффициент Ки"
... -Mode variant -Name 1
... -Mode templates -Name ВидНалоговойБазы

Режимы

РежимБез -NameС -Name
overviewНавигационная карта схемы + подсказки Next—
query—Текст запроса набора (с оглавлением батчей)
fieldsКарта: имена полей по наборамДеталь поля: набор, тип, роль, формат
linksВсе связи наборов—
calculatedКарта: имена вычисляемых полейВыражение + заголовок + ограничения
resourcesКарта: имена ресурсов (* = групповые формулы)Формулы агрегации по группировкам
paramsТаблица параметров: тип, значение, видимость—
variantСписок вариантовСтруктура группировок + фильтры + вывод
templatesКарта привязок шаблонов (field/group)Содержимое шаблона: строки, ячейки, выражения
trace—Полная цепочка: набор → вычисление → ресурс
fullПолная сводка: overview + query + fields + resources + params + variant—

Типичный workflow

  1. overview — понять структуру, увидеть подсказки
  2. trace -Name <поле> — узнать как считается колонка отчёта (за один вызов)
  3. query -Name <набор> — посмотреть текст SQL-запроса
  4. variant -Name <N> — посмотреть группировки и фильтры варианта

5. MXL — Макет табличного документа (Template.xml)

Читает Template.xml табличного документа и выводит компактную сводку: именованные области, параметры, наборы колонок.

Параметры

ПараметрПо умолчаниюОписание
TemplatePath—Прямой путь к Template.xml
ProcessorName—Имя обработки (альтернатива пути)
TemplateName—Имя макета (альтернатива пути)
SrcDirsrcКаталог исходников
FormattextФормат вывода: text или json
WithTextfalseВключить статический текст и шаблоны
MaxParams10Макс. параметров в списке на область
Limit150Макс. строк вывода
Offset0Пропустить N строк (для пагинации)
powershell.exe -NoProfile -File .claude/skills/inspect/scripts/mxl-info.ps1 -TemplatePath "<путь>"

Или по имени обработки/макета:

... -ProcessorName "<Имя>" -TemplateName "<Макет>" [-SrcDir "<каталог>"]

Дополнительные флаги:

... -WithText              # включить текстовое содержимое ячеек
... -Format json           # JSON-вывод для программной обработки
... -MaxParams 20          # показать больше параметров на область
... -Offset 150            # пагинация

Чтение вывода

Named areas — области перечислены в порядке документа (сверху вниз):

--- Named areas ---
  Заголовок          Rows     rows 1-4     (1 params)
  Строка             Rows     rows 14-14   (8 params)
  Итого              Rows     rows 16-17   (1 params)

Типы: Rows (горизонтальная), Columns (вертикальная), Rectangle (строки+колонки), Drawing (рисунок/штрихкод).

Parameters by area — параметры с detailParameter (расшифровка):

  Строка: НомерСтроки, Товар, Количество, Цена, Сумма, ... (+3)
    detail: Товар->Номенклатура

Параметры [tpl] — встроены в шаблонный текст: "Инв № [ИнвентарныйНомер]", заполняются программно как обычные.

Intersections (при наличии Rows+Columns): Макет.ПолучитьОбласть("ВысотаЭтикетки|ШиринаЭтикетки")


6. Подсистема (XML-выгрузка)

Читает XML подсистемы и выводит компактное описание: состав, дочерние подсистемы, командный интерфейс, дерево иерархии.

Параметры

ПараметрОписание
SubsystemPathПуть к XML-файлу подсистемы, каталогу подсистемы или каталогу Subsystems/ (для tree)
Modeoverview (default), content, ci, tree, full
NameDrill-down: тип объекта в content, секция в ci, имя подсистемы в tree
Limit / OffsetПагинация (по умолчанию 150 строк)
OutFileЗаписать результат в файл (UTF-8 BOM)
powershell.exe -NoProfile -File .claude/skills/inspect/scripts/subsystem-info.ps1 -SubsystemPath "<путь>"

Режимы

РежимЧто показывает
overview (default)Компактная сводка: свойства, состав (сгруппирован по типам), дочерние подсистемы, наличие CI
contentСписок Content с группировкой по типу. -Name Catalog — только каталоги
ciРазбор CommandInterface.xml: видимость, размещение, порядок команд/подсистем/групп
treeРекурсивное дерево иерархии подсистем с маркерами [CI], [OneCmd], [Скрыт]
fulloverview + content + ci в одном вызове

Примеры

# Обзор подсистемы
... -SubsystemPath Subsystems/Продажи.xml

# Состав — только документы
... -SubsystemPath Subsystems/Продажи.xml -Mode content -Name Document

# Командный интерфейс
... -SubsystemPath Subsystems/Продажи.xml -Mode ci

# Дерево подсистем от корня
... -SubsystemPath Subsystems -Mode tree

# Дерево для одной подсистемы
... -SubsystemPath Subsystems -Mode tree -Name Администрирование

7. Роль и права (Rights.xml)

Парсит Rights.xml роли и выдаёт компактную сводку: объекты сгруппированы по типу, показаны только разрешённые права. Сжатие: тысячи строк XML → 50–150 строк текста.

Параметры

ПараметрОписание
RightsPathПуть к файлу Rights.xml (обычно Roles/ИмяРоли/Ext/Rights.xml)
ShowDeniedПоказать запрещённые права (по умолчанию скрыты)
Limit / OffsetПагинация (по умолчанию 150 строк; 0 = без ограничений)
OutFileЗаписать результат в файл (UTF-8 BOM)
powershell.exe -File .claude/skills/inspect/scripts/role-info.ps1 -RightsPath <path> -OutFile <output.txt>

Важно: Всегда используй -OutFile и читай результат через Read tool. Прямой вывод в консоль ломает кириллицу.

Формат вывода

=== Role: БазовыеПраваБП --- "Базовые права: Бухгалтерия предприятия" ===

Allowed rights:

  Catalog (8):
    Контрагенты: Read, View, InputByString
    ...

  InformationRegister (6):
    ЦеныНоменклатуры: Read [RLS], Update
    ...

RLS: 4 restrictions
Templates: ДляРегистра, ПоЗначениям
Total: 138 allowed, 18 denied
  • [RLS] — право с ограничением на уровне записей (restrictionByCondition)
  • Вложенные объекты: Контрагенты.StandardAttribute.PredefinedDataName

Общие правила пагинации

Все скрипты поддерживают -Limit (по умолчанию 150) и -Offset. При усечении:

[TRUNCATED] Shown 150 of 220 lines. Use -Offset 150 to continue.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.