AGENT SKILL

1c-dispatch-gate

暂无简介

License 许可
MIT
最近更新
2026-11-14
Stars
★ 4
Forks
0

02 资源文件 2

03 SKILL.md 正文

1c-dispatch-gate — маршрутизатор этапа «Разработка»

Этот гейт отвечает за этап «Разработка» конвейера разработки (полный цикл задачи — 1c-delivery-gate: Планирование → Проектирование → Согласование → Разработка → внутренняя приёмка → код ревью → внешняя приёмка → Релиз). Если задача только ставится или сдаётся/принимается — сначала 1c-delivery-gate. Это точка входа в правила разработки: перед любой работой над кодом пройдите гейт-чек-лист и таблицу A. Другие скилы (1c-queries, 1c-forms, 1c-metadata…) открываются после этого шага — по результату маршрутизации.

Как пользоваться

  1. Задача идёт по конвейеру? Сверьте решение в листе замечаний 04a: отмеченное «Согласовано» — вход этапа «Разработка» (гейт 3→4, этап «Согласование», режимы manual/auto — 1c-delivery-gate §0). Файла нет или отмечено «Доработать» — 🔴 стоп: вернитесь на согласование пакета 02/03/04, код не начинайте. Вне конвейера (правка без задачи) — пропустите.
  2. Перед кодом/ревью — пройдите гейт-чек-лист (§1). Для каждого подходящего утверждения — отметить и открыть указанные скилы.
  3. По типу работы — сверьтесь с таблицей A (§2), откройте тематические скилы.
  4. В ревью — по сигналу в коде — таблица B (§3).
  5. После написания кода — 1c-thin-triggers (5 слоёв построчно) и 1c-code-review.

§1. Гейт-чек-лист (обязателен до написания кода)

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

Условие задачи Открыть скилы Что проверить
☐ Создаётся новый объект метаданных (справочник, документ, обработка, регистр, константа) 1c-metadata · 1c-security Случайные UUID (включая typeId/valueTypeId!), синоним ru/en, роли (№532), структура модуля
☐ Создаётся/правится форма 1c-forms 5 обязательных областей, бизнес-логика вне формы, modifiesStoredData
☐ Правка XML формы/объекта (.form/.mdo) вручную 1c-metadata LineNumber, PagesGroupExtInfo, <enabled> у Page, уникальность UUID, роли
☐ Есть запись/проведение документа или массовая запись 1c-events-transactions Шаблон транзакции, блокировки, ПроверитьЗаполнение()
☐ Контроль остатков / Остатки() / «проведение по остаткам» / отрицательные остатки 1c-events-transactions · 1c-metadata (registers-design §1) Целевой регистр — Balance/BalanceAndTurnovers (на Turnovers .Остатки() не компилируется); паттерн «запись → Остатки(&МоментВремени) → Отказ»
☐ Есть запросы 1c-queries Нет запроса в цикле, перечислены поля, СрезПоследних с параметрами
☐ Чтение/запись данных справочников/документов 1c-events-transactions · 1c-code-review Точечное чтение, ЗначенияРеквизитовОбъекта вместо .ПолучитьОбъект()
☐ Работа с файлами/сетью 1c-integration Только спецкаталог, таймауты, вне транзакции
☐ Есть команды формы, модифицирующие данные 1c-forms Флаг modifiesStoredData (Изменяет сохраняемые данные)
☐ Есть исключения/перехват (Попытка/Исключение) 1c-logging Логирование, не молчаливый перехват
☐ Это регламентное задание 1c-scheduled Идемпотентность, устойчивость, расписание реалистичное
☐ Пишутся/ревьюятся тесты (YaXUnit, Vanessa Automation) 1c-testing Arrange/Act/Assert, 4 типа кейсов, цели покрытия

Правило: ни одно подходящее утверждение не должно остаться неотмеченным. Если отмечено — скил открыт и прочитан, а не просто «посмотрели по названию».


§2. Таблица A — по типу работы

Тип работы / объект Скил
Полный цикл задачи: постановка → проектирование → приёмки → релиз 1c-delivery-gate (+ этапные скилы 1c-planning, 1c-solution-design, 1c-internal-acceptance, 1c-code-review, 1c-external-acceptance, 1c-release)
Архитектура (где разместить логику) 1c-arch-checklist · 1c-patterns
Запрос, СКД, динамический список 1c-queries
Отчёт на СКД (создание/ревью) 1c-queries (+ references/dcs-design.md)
Форма (создание новой) 1c-forms
Форма (доработка типовой БСП) 1c-forms (+ references/typical-forms-mod.md)
Форма (правка XML .form) 1c-metadata (+ references/metadata-xml.md)
Общий модуль (создание) 1c-metadata (+ references/module-templates.md)
Модуль объекта/менеджера 1c-metadata · 1c-events-transactions
Документ (проведение, движения) 1c-events-transactions
Регистр (создание/реструктуризация) 1c-metadata (+ references/registers-design.md)
Регистр (RLS, права) 1c-security
Регламентное задание 1c-scheduled
Отчёт, печатная форма 1c-reports
Обмен данными / интеграция 1c-integration
Локализация (многоязычность) 1c-localization
Права, роли, RLS 1c-security
Расширение (CFE) 1c-extensions
Асинхронный код (Асинх/Ждать) 1c-async
Тесты (unit на YaXUnit, BDD на Vanessa) 1c-testing
Командный интерфейс, кнопки 1c-ui-ux
Журналирование, исключения 1c-logging
Редактируемость объекта БСП (поставка/поддержка) 1c-platform-support
Командная разработка (хранилище конфигурации / EDT+git) 1c-collab
Обновление типовой конфигурации / БСП 1c-collab · 1c-platform-support
Выпуск релиза, поставка (.cf/.cfu/.cfe) 1c-collab · 1c-extensions

§3. Таблица B — по сигналу в коде

Увидели в коде паттерн из левой колонки → откройте указанные скилы.

Симптом / паттерн в коде Открыть
Движения.X / ОбработкаПроведения 1c-events-transactions
СрезПоследних / Остатки в запросе 1c-queries
.Ссылка. / .Регистратор. в запросе 1c-queries
НЕ ... В (ВЫБРАТЬ...) (анти-соединение) 1c-queries
Сообщить(...) 1c-ui-ux · 1c-forms
ОткрытьФормуМодально / Предупреждение 1c-async · 1c-forms
Асинх Процедура ПриОткрытии / ПередЗакрытием 1c-async
&НаСервере (контекстный вызов) 1c-performance
.ПолучитьОбъект() для чтения 1c-events-transactions
Текст = Текст + ... в цикле 1c-events-transactions (язык)
Попытка...Исключение без лога 1c-logging
Выполнить(...) / Вычислить(...) 1c-security
УстановитьПривилегированныйРежим(Истина) 1c-security
НСтр(...) / пользовательские тексты 1c-localization
Правка .form / .mdo вручную 1c-metadata
&Перед / &После / &ИзменениеИКонтроль 1c-extensions
ПриКомпоновкеРезультата 1c-queries (+ references/dcs-design.md)
НаборЗаписей.Записать() в цикле 1c-performance
Запрос в цикле (Запрос.Выполнить() в Для) 1c-queries
АвтоОбновление = Истина у списка 1c-performance
access_token / client_secret / секрет в коде или URL 1c-integration (+ references/integration-auth.md)
EnterpriseData / план обмена / конвертация данных 1c-integration (+ references/exchange-edm.md)

§4. По симптому проблемы

Симптом Открыть
«Тормозит», «зависает», «долго открывается» (профилактика в коде) 1c-performance · 1c-queries
🔴 «Уже тормозит на проде» / «конфликт блокировок» / «взаимоблокировка» — расследование инцидента 1c-performance (+ references/diagnostics.md: ТЖ, замеры, TDEADLOCK)
«Конфликт блокировок», «deadlock» 1c-events-transactions
«Данные рассинхронизированы» 1c-events-transactions
«Форма не открывается после правки» 1c-metadata
«Оригинальный метод не выполняется в расширении» 1c-extensions (ПродолжитьВызов)
«Не обновляется список» 1c-forms · 1c-performance
«Права не работают» 1c-security

Порядок работы на этапе «Разработка» (краткая выжимка)

Полная процедура — в AGENTS.md проекта (генерируется скилом 1c-project-bootstrap).

Этап 1. Подготовка к коду (вход этапа «Разработка» конвейера)

  1. Локализуйте объекты по имени и префиксу через find/grep.
  2. Поймите связи через карту движений проекта и поиск ссылок grep -rn.
  3. Прогоните этот гейт-чек-лист + arch-checklist (1c-arch-checklist).
  4. Откройте отобранные тематические скилы и прочитайте их текст, не полагайтесь на память.
  5. 🔴 Сверьте план изменений со спецификацией 03 (если задача идёт по конвейеру): перечень объектов/файлов из «Объекты метаданных» — это границы задачи. За границами — стоп и вопрос РП/архитектору, а не молчаливая правка: несогласованное смежное возвращается с приёмки классом A/B. Состав изменился осознанно — сначала обновите 03 (при развилке — ADR, 1c-solution-design), потом код.

Постановка задачи («что и зачем») и проектирование («как должно работать»: сценарий, спецификация, критерии приёмки) — предыдущие этапы конвейера разработки, скилы 1c-planning и 1c-solution-design. Самопроверка готового кода перед сдачей заказчику — 1c-internal-acceptance.

Этап 2. Реализация

  1. Пишите код по прочитанным правилам.
  2. 🔴 Правки — только в объектах из плана изменений (03). Потребовалось затронуть смежный объект — вернитесь к п. 5 Этапа 1: согласовать выход за границы и обновить 03, а не расширять молча.
  3. Перед новой функцией — проверьте переиспользование (grep по БСП и прикладным модулям).
  4. Комментируйте «почему», а не «что».
  5. 🔴 Не выдумывайте функции. Любая не-100%-стандартная функция должна быть определена в проекте или раскрыта через стандартные средства.
  6. 🔴 Сверяйтесь с версией платформы (compatibilityMode в Configuration.mdo).

Этап 3. Самопроверка

  1. Прогоните 1c-thin-triggers — построчно по 5 слоям.
  2. Сверьтесь с 1c-code-review — по секции типа изменённого объекта.
  3. 🟡 Повторный прогон — после паузы или с установкой «критик».

Детали (читать по необходимости)

  • references/dispatch-map.md — полная карта диспетчеризации (больше деталей, чем этот SKILL.md)
  • references/retrieval-rules.md — словарь синонимов «фрагмент кода / диагноз → стандарт» (для реверса от кода к стандартам)

04 同仓库更多 Skills