Добавить Как можно применять Cursor AI

2026-07-23 13:59:18 +00:00
parent e598ef0cf1
commit 0eb96c4d9f
1 changed files with 78 additions and 0 deletions
@@ -0,0 +1,78 @@
 Cursor для 1С — это не «чат вместо конфигуратора», а **среда поверх выгрузки конфигурации в файлы**, где AI читает и правит BSL/XML так же, как код в обычном репозитории. Конфигуратор остаётся точкой загрузки в ИБ и отладки.
 ## Исходная модель работы
 1. Конфигурация/расширение в git как файлы (`*.bsl`, `*.xml`).
 2. Cursor открывает корень репозитория.
 3. Разработчик ставит задачу агенту → правки в исходниках.
 4. `commit` / `push` → загрузка в ИБ через конфигуратор (часто с другого ПК).
 Без выгрузки в файлы Cursor почти бесполезен: ему нечем оперировать.
 ## Что реально ускоряет опытного 1С-ника
 | Задача | Как использовать Cursor |
 |--------|-------------------------|
 | Найти, где считается X | «Где формируется регистр … при проведении ЗаказКлиента?» |
 | Дописать процедуру по образцу | «Сделай по аналогии с …, префикс РК_» |
 | Расширение `&ИзменениеИКонтроль` | Дать эталон и правила `#Вставка` / `#Удаление` |
 | Рефакторинг/массовые правки | Переименовать, вынести общий код, пройти связанные модули |
 | Анализ расхождений old/new | Сравнить два дерева выгрузки, маппинг, отчёты |
 | Документация и BSL-скрипты | Линейный код для консоли / `run_bsl`, wiki, разбор логов |
 | Ревью | «Проверь дифф: директивы препроцессора, сервер/клиент, запросы» |
 Слабо подходит для: дизайна форм в визуальном редакторе, отладки на живой ИБ «как в EDT», тонкой настройки прав/ролей без явной модели в файлах.
 ## Как «научить» Cursor вашей базе
 Опытный разработчик выигрывает не промптами, а **контекстом проекта**:
 1. **Rules** (`.cursor/rules/`, `.cursorrules`) — структура каталогов, термины (исходная/целевая), стандарты расширений, «не собирать .cf/.epf без просьбы».
 2. **Документация в `docs/`** — агент читает её по запросу; лучше короткие канонические правила, чем портянки.
 3. **Индекс метаданных** (как `tools/index` в этом проекте) — быстрее, чем grep по всему `src/`: «реквизиты ЗаказКлиента», «движения документа», «кто пишет в регистр».
 4. **@-ссылки** — явно указывать модуль, документ, wiki, похожий кусок кода: меньше галлюцинаций.
 Чем жёстче зафиксированы соглашения (префиксы, области, директивы), тем реже агент «пишет как на JS».
 ## Режимы работы на практике
 - **Ask** — только разобраться: «как устроен учёт серий», «откуда берётся цена».
 - **Plan** — крупная доработка с развилками: обмен, перенос, смена модели учёта.
 - **Agent** — правки в файлах по уже согласованному плану.
 - **Chat по открытому файлу** — точечно: «допиши обработчик», «исправь запрос».
 Для сложного: сначала Plan («что меняем в метаданных и модулях»), потом Agent («внеси»), потом ревью диффа глазами.
 ## Паттерны промптов под 1С
 Хорошо:
 - «В расширении `crm3-26.rhana` измени процедуру X по правилам `&ИзменениеИКонтроль`: полный оригинал, новый код только в `#Вставка`. Эталон — процедура Y в основной конфигурации.»
 - «Найди все места, где заполняется серия в РТУ, и предложи единый подход; код пока не пиши.»
 - «Напиши линейный BSL (без Процедура/Функция) для анализа остатков; вывод через `ОбщегоНазначения.СообщитьПользователю`.»
 Плохо:
 - «Сделай учёт серий» без базы/объектов/ограничений.
 - «Исправь проведение» без номера документа, лога ошибки и модуля.
 ## Граница ответственности
 Вы оставляете за собой:
 - смысл учёта и приёмку;
 - загрузку в ИБ и проверку проведения;
 - спорные места типовой УТ/ERP (агент может уверенно ошибаться).
 Агенту отдаёте:
 - навигацию по большому дереву;
 - шаблонный BSL и однотипные правки;
 - сверки, скрипты, черновики запросов;
 - оформление расширений по вашим правилам.
 ## Минимальный старт для коллеги
 1. Выгрузка конфигурации/расширения в git, открыть корень в Cursor.
 2. Одна страница правил: пути, префиксы, стандарты расширений, как грузить в ИБ.
 3. Первая задача — **поиск и объяснение**, не «перепиши половину конфигурации».
 4. Вторая — **маленькая правка в расширении** с ревью диффа.
 5. По мере работы — копить в rules то, что агент уже один раз «забыл».
 Итог для стажёра с опытом: Cursor — это **второй программист, который знает файлы конфигурации и ваши правила репозитория**, а не замена платформы. Сила — в связке «выгрузка → rules/docs/индекс → точечные задачи → ваша приёмка в конфигураторе».