Перенос исторических доработок

Repo script: ./scripts/python/run-python.sh

Операции метаданных выполняйте подкомандой metadata по навыку metadata-use; на Windows — scripts/python/run-python.ps1 metadata. Эта точка входа не выполняет исследование или весь перенос автоматически.

Переносите хозяйственную потребность, а не весь набор исторических объектов. Если запрошен анализ или проектирование, закончите решением и планом; реализацию выполняйте только в разрешённом объёме. Согласованный перенос включает загрузку и проверку в согласованной для задачи базе по правилу ниже. Навык сам по себе не разрешает создание баз, изменение правил обмена или отказ от данных.

Определить исходные условия

1. Зафиксируйте сценарий пользователя, границы переноса, точные корни и ревизии исторических исходников, целевой типовой конфигурации и расширения. Установите релиз, платформу и режим совместимости затронутых систем.
2. Перед исследованием прочитайте регламент поиска. Проверьте область и готовность BSL Analyzer; поиск в индексе целевой конфигурации не является исследованием исторической.
3. Подтвердите историческую доработку сравнением с соответствующей типовой версией либо существующим исследованием с проверяемыми ссылками. Если эталона нет, отметьте ограничение: нестандартное имя не доказывает происхождение доработки.
4. Проследите участвующие реквизиты, формы, обработчики, запросы и движения. Включайте только зависимости согласованного сценария, а не весь объект-владелец.

Проверить новую систему до изменения исходников

Исследуйте отдельно типовую конфигурацию и существующее расширение. Проверьте уже выполненный перенос по смыслу, сопоставлениям и использованию: имя, префикс и даже объект-владелец могли измениться.

Для типового аналога ищите реализацию хозяйственного сценария, а не только одноимённый реквизит. Проверьте применимые настройки и функциональные опции: выключенная возможность не равна отсутствующей. Сопоставьте смысл и типы данных, действия пользователя, расчёты, движения, отчёты и существенные исключения в пределах затронутого сценария.

Подтверждайте вывод исходниками точного целевого релиза и официальной документацией; если вывод зависит от исполнения или настроек ИБ — разрешённой проверкой в точной базе. Найденный исходник не доказывает его загрузку в базу. Пустая выдача поиска не доказывает отсутствие функционала, сходство названий — эквивалентность.

Подтверждённый результат	Решение
Доработка уже перенесена	Использовать существующую реализацию; исправить только согласованный недостаток
Типовой функционал полностью покрывает потребность	Предложить типовой сценарий без дублирующей доработки
Типовой функционал покрывает часть потребности	Сохранить типовую основу, реализовать только перечисленные отличия
Подходящего аналога нет после проверки связанных механизмов	Спроектировать минимальный перенос с указанием проверенной области
Соответствие не доказано	Указать недостающие доказательства; не выбирать реализацию по догадке

Не меняйте молча явный выбор пользователя. Замена поведения, отказ от данных или изменение их хозяйственного смысла требуют согласования. Если исследование выявило конфликт с заданным переносом, объясните его до зависимых изменений.

Зафиксировать решение и выполнить разрешённый перенос

В существующем change используйте traceability.md, не создавайте параллельный реестр. Если change нет и запрошен только анализ, дайте результат в ответе. Для каждой доработки укажите:

• потребность и ссылки на историческую реализацию;
• рассмотренный типовой аналог и существующую реализацию в расширении;
• решение, доказательства и оставшуюся неопределённость;
• явное сопоставление «источник → приёмник», включая типы и изменения поведения;
• необходимые изменения, исключённые части, сценарий проверки и влияние на миграцию.

Для постоянных бизнес-объектов предлагайте имя <Префикс>_<ПредметноеИмя>, где <Префикс> — префикс объектов расширения, принятый в проекте. Не добавляйте суффикс версии исходной конфигурации только из-за происхождения объекта. Историческое имя храните в сопоставлении «источник → приёмник». Суффикс допустим, если объект явно исторического назначения. Это правило не разрешает автоматически переименовывать существующие объекты: такой переход согласуется отдельно с сохранением идентификаторов, данных и зависимостей.

После разрешения реализации применяйте существующие навыки по назначению:

• metadata-use — создание, заимствование и редактирование метаданных через просмотренный план CLI; не копируйте XML и не угадывайте соответствия.
• Для изменения формы сначала заимствуйте точную типовую форму новой системы через form.borrow, проверьте её открытие и нужные штатные действия без доработки, затем внесите изменения и повторите тот же сценарий. Ошибку исходной заимствованной формы устраните до добавления новой логики; если проверка запрещена, зафиксируйте это и не объявляйте исходную форму проверенной. Порядок работы с формой расширения — по cfe-form-workflow.
• BSL адаптируйте к целевым механизмам отдельно и проверяйте через 1c-check-bsl. Недостающую операцию метаданных добавляйте по правилам metadata-use, не создавайте второй редактор.
• Для EPF/ERF используйте prepare-external-artifact или ordinary-form-workflow, не дублируя их инструкции здесь.
• Загрузку и проверки в ИБ выполняйте только штатными профильными обёртками; при запуске платформы используйте 1c-observe-run.

Перед использованием перечисленного навыка читайте его актуальный SKILL.md. Ограничения пользователя на проверки действуют на весь процесс.

Ссылочные типы в расширении

Для переносимых реквизитов, в том числе в табличных частях и формах, проверьте каждый прикладной тип: объект должен быть собственным объектом расширения либо явно заимствованным объектом точной целевой конфигурации. Если подходит типовой объект, заимствуйте его через metadata-use, сохраняя связь с его идентификатором; не создавайте одноимённую копию. Строка EnumRef.Имя или CatalogRef.Имя в XML сама по себе не подтверждает оформление зависимости.

После разрешённой загрузки выгрузите затронутое расширение обратно и сопоставьте типы с планом. Неожиданную замену именованного типа на v8:TypeId разберите: найдите объект по идентификатору и проверьте его наличие и заимствование в расширении. Сам идентификатор не ошибка; неразрешённая зависимость блокирует приёмку. Проверьте отображение типа в редакторе расширения и доступность нужных значений в форме. Успешная компиляция и тип в объединённых метаданных работающей базы не заменяют эти проверки. Если интерфейс недоступен, явно оставьте его проверку незавершённой.

Загрузить и проверить в согласованной базе

Согласование реализации переноса включает загрузку доработки и её проверку в уже выбранной и согласованной пользователем базе без повторного разрешения. Навык не задаёт базу по умолчанию. Явное ограничение «только исходники», запрет загрузки или проверок имеет приоритет. Запрос только анализа или проектирования загрузку не разрешает. Перед загрузкой сверьте состав всего загружаемого расширения: посторонние несогласованные изменения в это разрешение не входят.

Если пользователь уже разрешил загрузку и проверки текущей доработки и выбрал целевую базу, после проверки исходников продолжайте загрузку и приёмочный сценарий без повторного запроса того же разрешения. Не завершайте такую задачу только проверкой XML. Перед запуском сверьте профиль с фактической базой; используйте штатную профильную обёртку и 1c-observe-run.

Если целевая база ещё не согласована, запросите её выбор до загрузки. Наличие профиля не заменяет согласование. Уже согласованный выбор применяйте в его объёме, не задавая вопрос снова.

При смене базы, расширении состава загружаемых изменений или необходимости разрушительного действия согласуйте новый объём отдельно. Постоянное разрешение не включает завершение чужих сеансов и перезапуск служб. Если загрузка или приёмка заблокированы, сообщите точный этап и причину; не объявляйте перенос проверенным в базе. Разрешение на загрузку расширения не разрешает миграцию данных.

Проверить результат и влияние на миграцию

Раздельно подтвердите структуру метаданных, компиляцию и хозяйственный сценарий. Сравните ожидаемый результат доработки и сохранность затронутого типового поведения. Для форм проверьте открытие, команды и редактирование данных; сборка или проверка XML этого не подтверждают.

Оцените влияние на миграцию: исторические данные, ссылки, повторная загрузка и перепроведение, если они затронуты. Найдите подходящий связанный change до создания нового. Передача требований не разрешает реализацию или запуск миграции.

В результате раздельно укажите готовность структуры, поведения и переноса данных, выполненные проверки и ограничения. Добавленный реквизит не означает переноса заполняющего его алгоритма; типовой аналог не означает совместимости исторических данных без преобразования.