| name | new-applied-object |
| description | Исследование прикладного объекта метаданных 1С перед реализацией — глубокий анализ фикстур, XSD, справки 1С и соседей в codebase. Рекурсивно выявляет подчинённые объекты и извлекает для них XML-фикстуры. Выдаёт консолидированный отчёт для `/write-a-prd`. Используй при добавлении нового прикладного объекта (Документ, Последовательность, Перечисление, Нумератор и т.п.). |
Исследование прикладного объекта
Скилл запускает сценарий исследования нового прикладного объекта. Устойчивые правила исследования живут в .agents/knowledge/metadata/.
Перед работой обязательно прочитай:
.agents/knowledge/metadata/INDEX.md.agents/knowledge/metadata/sources-of-truth.md.agents/knowledge/metadata/object-research.md.agents/knowledge/metadata/registries.md
Скилл ничего не реализует: не пишет rules.ts, types.ts, register.ts, тесты и не трогает реестры. Единственные файловые результаты — папки и XML-фикстуры подчинённых объектов, извлечённые из фикстур родителя.
Результат — структурированный отчёт в чате для последующей спецификации и плана.
Триггер
- Аргумент — путь к каталогу нового прикладного объекта (обычно
packages/core/metadata/appliedObjects/metadata<Name>/). В каталоге уже должны лежать XML-фикстуры (__fixtures__/full.xml, minimal.xml; желательно __fixtures__/sync/xml/<Имя>.xml).
- Если фикстур нет — останови скилл, попроси пользователя добавить минимум один
full.xml.
Обязательные локальные ресурсы
Перед началом обязательно прочитай local-resources.md рядом с этим SKILL.md (.agents/skills/new-applied-object/local-resources.md). Там приватные пути для Deep Scan:
- XSD-каталог (
.xsd*_root.res файлы платформы 1С);
- Каталог справки 1С
hlp/1/FileStorage/objects, из которого извлекаются русские имена свойств, типы платформы и описания.
- Карта ru↔en (
~/.cache/mcp-bsl/ru-en-map.json).
Если нет файла local-resources.md или любого из трёх ресурсов — остановись, выведи сообщение «настрой локальные ресурсы» со ссылкой на .agents/skills/new-applied-object/local-resources.md. Скилл без них работать не будет.
Фаза 1. Deep Scan
Работай автономно, без вопросов пользователю. Следуй .agents/knowledge/metadata/object-research.md и источникам истины из .agents/knowledge/metadata/sources-of-truth.md.
Внутренний отчёт (не в чат)
По итогу Deep Scan у агента должна быть таблица:
Родитель: Metadata<Name>
├── container: <XMLTag>
├── свойства: [ {русский, английский, XSDtag, тип, источник: фикстура/XSD/справка}, ... ]
├── подчинённые: [
│ { путь, container, свойства: [...], подчинённые: [...] }
│ ]
├── внешние файлы: [ Ext/AdditionalIndexes.xml → tag "AdditionalIndexes", тип уже есть ]
├── свойства вне фикстур: [ objectBelonging, extendedConfigurationObject, ... ]
├── реестры-дельта: [ новые ключи которые надо добавить ]
└── риски инфраструктуры: [ ... ]
Фаза 2. Grill-style вопросы
Формат grill-style: по одному вопросу, с предлагаемым ответом и обоснованием. Агент не переходит к следующему, пока не получил ответ.
Обязательные блоки (порядок):
- Свойства родителя — таблица (русский / английский TS-ключ / XSD-тег / тип / YAML-ключ / источник). «Верно? Добавить/убрать? Переименовать?»
- Свойства вне фикстур — найденные в XSD базового класса или в справке 1С, но отсутствующие в фикстурах (кандидаты
objectBelonging, extendedConfigurationObject и т.п.). Для каждого рекомендуемый режим (runtimeOnly, toYAML: false, fromYAML: false, или не включать).
- Подчинённые объекты — список рекурсивно найденных, с указанием путей созданных папок и XML-фикстур. Порядок создания (сначала листья). «Пути в
commonObjects/ — OK? Создавать всех сейчас или некоторых отложить?»
- Внешние файлы (
Ext/*.xml или отдельные .bsl-модули) — для каждого: известный механизм (как у соседа) / runtimeOnly / не включать в rules.
- Особые свойства — модули (
RecordSetModule, ObjectModule), Predefined, кастомные теги — как обрабатывать.
- Риски инфраструктуры — если Deep Scan обнаружил статически (неизвестный тип в реестрах, необычные
xmlParents, возможные баги общих from/to XML правил для нужного типа) — для каждого предлагаемое действие.
Если в ходе ответов выясняется, что решение пользователя требует нового под-вопроса — задавай его тут же, не копи на конец.
Фаза 3. Консолидированный отчёт в чате
Один сообщение-markdown по шаблону:
# Research: Metadata<Name>
## Контекст
- Путь: `packages/core/metadata/appliedObjects/metadata<Name>/`
- Контейнер XML: `<Container>`
- XSD-источник: `<файл>`
- Референс-соседи: `<1-2 пути>`
## Свойства
| TS-ключ | XML-тег | YAML-ключ | Тип | Default | Источник |
|---|---|---|---|---|---|
| ... | ... | ... | ... | ... | ... |
## Подчинённые (порядок создания — сначала листья)
1. `Metadata<Sub1>` → `packages/core/metadata/commonObjects/metadata<Sub1>/`
- Фикстуры извлечены: full.xml [+ minimal.xml]
- Свойства: …
- Подчинённых нет [или список]
2. `Metadata<Sub2>` → ...
## Внешние файлы
- `Ext/<File>.xml` — обрабатывать как свойство `<key>: { type: "<T>" }` (по аналогии с <сосед>)
## Свойства вне фикстур (по решению пользователя)
- `objectBelonging` — `SystemEnumeration: ObjectBelonging`, `toYAML: false, fromYAML: false`
- `extendedConfigurationObject` — `string`, `runtimeOnly: true`
## Дельта реестров
- `MetadataItemTypeRegistry`: добавить `Metadata<Name>`, `Metadata<Sub1>`, `Metadata<Sub2>`
- `PropertyTypeRegistry`: добавить `Metadata<Name>`, `Metadata<Sub1>`, `Metadata<Sub1>s` (коллекция), `Metadata<Sub2>`, `Metadata<Sub2>s`
- `PropertyRuleTypeKeys`: те же записи
## Ответы пользователя на грил
1. **Q:** <вопрос> — **A:** <ответ>
2. ...
## Риски / заметки к выполнению
- <перечень статически выявленных>
## Непокрытые свойства (нет в фикстурах, но объявлены в rules)
- ...
## Следующий шаг
Сформируй PRD через `/write-a-prd` на основе этого отчёта. Реализация — отдельная фаза после PRD/plan.
Что НЕ делает скилл
- Не создаёт
rules.ts, types.ts, register.ts, index.ts.
- Не регистрирует ничего в
MetadataItemTypeRegistry/PropertyTypeRegistry/PropertyRuleTypeKeys.
- Не пишет тесты (
fromXML.test.ts, toXML.test.ts, fromYAML.test.ts, toYAML.test.ts, convertFromXML.test.ts, syncToXML.test.ts).
- Не запускает
pnpm test и type-check.
- Не правит общую инфраструктуру (
metadataRef, metadataField и т.п.), даже если Deep Scan обнаружил подозрение на баг — это идёт в раздел «Риски».
Что делает (единственные файловые результаты)
- Папки подчинённых:
packages/core/metadata/commonObjects/metadata<Sub>/.
- XML-фикстуры подчинённых:
packages/core/metadata/commonObjects/metadata<Sub>/__fixtures__/full.xml (+ minimal.xml).
Все остальные файлы создаются на этапе выполнения плана (после /write-a-prd → /prd-to-plan → ручная реализация по плану).
Следующие сценарии
- grill-style — методика вопросов «по одному с рекомендацией».
/write-a-prd — следующий шаг после этого скилла.
