1c-dispatch-gate
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 4
- Forks
- 0
02 资源文件 2
- 参考文档references/dispatch-map.md13.4 KB
- 参考文档references/retrieval-rules.md6.8 KB
03 SKILL.md 正文
1c-dispatch-gate — маршрутизатор этапа «Разработка»
Этот гейт отвечает за этап «Разработка» конвейера разработки (полный цикл задачи —
1c-delivery-gate: Планирование → Проектирование → Согласование → Разработка → внутренняя приёмка → код ревью → внешняя приёмка → Релиз). Если задача только ставится или сдаётся/принимается — сначала1c-delivery-gate. Это точка входа в правила разработки: перед любой работой над кодом пройдите гейт-чек-лист и таблицу A. Другие скилы (1c-queries,1c-forms,1c-metadata…) открываются после этого шага — по результату маршрутизации.
Как пользоваться
- Задача идёт по конвейеру? Сверьте решение в листе замечаний 04a:
отмеченное «Согласовано» — вход этапа «Разработка» (гейт 3→4, этап
«Согласование», режимы manual/auto —
1c-delivery-gate§0). Файла нет или отмечено «Доработать» — 🔴 стоп: вернитесь на согласование пакета 02/03/04, код не начинайте. Вне конвейера (правка без задачи) — пропустите. - Перед кодом/ревью — пройдите гейт-чек-лист (§1). Для каждого подходящего утверждения — отметить и открыть указанные скилы.
- По типу работы — сверьтесь с таблицей A (§2), откройте тематические скилы.
- В ревью — по сигналу в коде — таблица B (§3).
- После написания кода —
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. Подготовка к коду (вход этапа «Разработка» конвейера)
- Локализуйте объекты по имени и префиксу через
find/grep. - Поймите связи через карту движений проекта и поиск ссылок
grep -rn. - Прогоните этот гейт-чек-лист + arch-checklist (
1c-arch-checklist). - Откройте отобранные тематические скилы и прочитайте их текст, не полагайтесь на память.
- 🔴 Сверьте план изменений со спецификацией 03 (если задача идёт по конвейеру):
перечень объектов/файлов из «Объекты метаданных» — это границы задачи.
За границами — стоп и вопрос РП/архитектору, а не молчаливая правка:
несогласованное смежное возвращается с приёмки классом A/B. Состав
изменился осознанно — сначала обновите 03 (при развилке — ADR,
1c-solution-design), потом код.
Постановка задачи («что и зачем») и проектирование («как должно работать»: сценарий, спецификация, критерии приёмки) — предыдущие этапы конвейера разработки, скилы
1c-planningи1c-solution-design. Самопроверка готового кода перед сдачей заказчику —1c-internal-acceptance.
Этап 2. Реализация
- Пишите код по прочитанным правилам.
- 🔴 Правки — только в объектах из плана изменений (03). Потребовалось затронуть смежный объект — вернитесь к п. 5 Этапа 1: согласовать выход за границы и обновить 03, а не расширять молча.
- Перед новой функцией — проверьте переиспользование (
grepпо БСП и прикладным модулям). - Комментируйте «почему», а не «что».
- 🔴 Не выдумывайте функции. Любая не-100%-стандартная функция должна быть определена в проекте или раскрыта через стандартные средства.
- 🔴 Сверяйтесь с версией платформы (
compatibilityModeвConfiguration.mdo).
Этап 3. Самопроверка
- Прогоните
1c-thin-triggers— построчно по 5 слоям. - Сверьтесь с
1c-code-review— по секции типа изменённого объекта. - 🟡 Повторный прогон — после паузы или с установкой «критик».
Детали (читать по необходимости)
references/dispatch-map.md— полная карта диспетчеризации (больше деталей, чем этот SKILL.md)references/retrieval-rules.md— словарь синонимов «фрагмент кода / диагноз → стандарт» (для реверса от кода к стандартам)
04 同仓库更多 Skills
1c-valid
Эталонный валидный скил для тестов. Use when testing validator — все правила соблюдены, ошибок быть не должно.
1c-no-license
Скил без поля license — должен дать ошибку об обязательном поле.
1c-broken
暂无简介
1c-ui-ux
暂无简介
1c-thin-triggers
暂无简介
1c-testing
暂无简介