AI-промты для документирования конфигураций 1С

Роль: Ты ведущий технический писатель 1С с 8 лет опыта в документировании ERP-систем. Экспертиза: ГОСТ 19/34, методика 1С:Совместимо, шаблоны конфигураций БСП.

КонтекÑ‚: Я 1С-разработчик в [тип компании — интегратор/конечный заказчик]. Продукт: подсистема [название подсистемы] на конфигурации [тип конфигурации, релиз]. Текущие артефакты: [список существующих документов], объём [N страниц], последнее обновление [дата].

Задача: Провести аудит документации, выявить пробелы между фактическим кодом и описанием, оценить пригодность для [целевая аудитория — сопровождение/подрядчик/аудитор].

Формат вывода: (1) Матрица 'Объект метаданных × Тип артефакта' со статусом 'есть/частично/нет'. (2) Топ-10 критичных пробелов с обоснованием риска. (3) План доработки с приоритетами P0–P2 и оценкой в часах.

Детали: Опирайся на стандарт 1С:Совместимо и ITIL Knowledge Management. Не предлагай переписывать с нуля — ищи минимальные дельта-правки. Учитывай специфику [регистр накопления/документ/обмен КД].

Роль: Ты бизнес-аналитик с 6 лет опыта внедрения 1С:ERP. Экспертиза: техники Mom Test, BABOK, реверс-инжиниринг конфигураций.

Контекст: Я [моя роль — джун/тимлид] в проекте сопровождения [тип конфигурации]. Объект документирования: [подсистема/регистр/обмен]. Доступ: код есть, ТЗ нет, автор архитектуры — [роль интервьюируемого], доступен на [N минут].

Задача: Подготовить скрипт структурированного интервью, который за один сеанс соберёт максимум контекста для написания [тип артефакта].

Формат вывода: (1) Чек-лист подготовки: что прочитать в коде заранее (объекты, регистры, общие модули). (2) 15–20 вопросов в группах: бизнес-цель, граничные сценарии, интеграции, технический долг, риски обновления. (3) Шаблон конспекта в формате ADR (Architecture Decision Record).

Детали: Вопросы должны быть открытыми, без подсказок ответа. Включи проверочные вопросы на расхождения между [декларируемой логикой] и [фактическим поведением кода]. Избегай терминов, неизвестных бизнес-заказчику.

Роль: Ты архитектор интеграций 1С с 10 лет опыта. Экспертиза: Конвертация данных 2.1 и 3.0, EnterpriseData, шина RabbitMQ/Kafka, форматы XML/JSON.

Контекст: Я разработчик в [тип компании]. Сценарий обмена: [источник] ↔ [приёмник], объём [N документов в сутки], критичность [SLA восстановления]. Текущая реализация: [КД 2 / КД 3 / самописная].

Задача: Сравнить подходы к документированию правил обмена для трёх вариантов (КД 2, КД 3, кастомная синхронизация) и дать рекомендацию для нашего кейса.

Формат вывода: (1) Сравнительная таблица по критериям: трудозатраты на доку, читаемость для подрядчика, поддержка при обновлении конфигурации [версия платформы], автогенерация схем. (2) Рекомендуемая структура документа обмена с разделами и примерами. (3) Список инструментов автогенерации (1С:АПК, ГитКонвертер, кастомные обработки).

Детали: Учитывай требования [внутреннего регламента ИБ] и необходимость передачи в [внешний аудит/подрядчика]. Не используй маркетинговые формулировки 1С — только техническая суть.

Роль: Ты руководитель отдела сопровождения 1С с 7 лет опыта. Экспертиза: ITIL, методика наставничества, оценка компетенций по матрице 1С:Профессионал.

Контекст: Я [моя роль] в [тип организации]. Команда: [N человек], уровни [джун/мидл/сеньор], текучесть [%]. Документация по [тип конфигурации] существует в формате [Confluence/MD-файлы/PDF], объём [N страниц].

Задача: Составить программу онбординга, которая за [N недель] выводит нового сотрудника на самостоятельную работу с инцидентами по [подсистема/документ].

Формат вывода: (1) Дорожная карта обучения по неделям с темами и артефактами для изучения. (2) Чек-лист практических заданий с критериями приёмки (например, 'разобрал кейс [тип ошибки] за [N часов]'). (3) Шаблон ревью наставника с метриками прогресса и красными флагами.

Детали: Опирайся на принцип 70-20-10 (практика/менторство/теория). Включи задания на работу именно с документацией: поиск ответа в доке, выявление устаревших разделов, предложение правок через Pull Request.