version: "1.0.1" name: vanessa-authoring description: "Use for создания и доработки feature-сценариев Vanessa Automation по реальным требованиям проекта." uses_capabilities:

• run_vanessa
• build_project

Авторинг сценариев Vanessa Automation

Алгоритм написания

1. Определи источник требования — спецификация или бизнес-кейс (vanessa-scenario-policy).
2. Определи под каким пользователем выполняется сценарий (см. «Пользовательский контекст»).
3. Найди подходящие шаги: сначала в библиотеке Vanessa, затем в сценариях проекта.
4. Напиши один smoke-сценарий: открыть → одно действие → одно наблюдаемое следствие.
5. Если шага нет — пометь # unknown_step_candidate, не изобретай BSL-шаг.
6. Передай сценарий на прогон через v8-runner (v8-runner test va).

Анатомия feature-файла

# language: ru
# encoding: utf-8
# Задача: task-103 — Оформление заказа клиента через портфель
 
@task-103 @тег-фичи
Функциональность: Краткое название
 
Как <роль пользователя>
Я хочу <что сделать>
Чтобы <бизнес-польза>
 
Контекст:
    Дано Я запускаю тест-клиент для пользователя "Логин" с паролем "Пароль" или подключаю уже существующий
 
Сценарий: Название сценария
    Когда <действие>
    И    <следующее действие>
    Тогда <ожидаемый результат>

• Контекст: выполняется перед каждым сценарием файла.
• Ключевые слова шагов: Дано, Когда, Тогда, И, Затем — взаимозаменяемы синтаксически.
• Строки — в апострофах или кавычках; спецсимволы: \', \", \\.
• Структура сценария: + Примеры: — запускает сценарий по каждой строке таблицы параметров.
• @tree в заголовке — включает Turbo Gherkin: отступы Tab задают дерево шагов (пробелы недопустимы!).
• @exportscenarios — делает сценарий доступным как подсценарий из другого feature-файла.

Пользовательский контекст

MUST: каждый сценарий выполняется под конкретным бизнес-пользователем, а не под admin/AgentAI. Исключение — только если проверяемая функция доступна исключительно администратору.

Как определить пользователя:

1. Указан в описании задачи → использовать его.
2. Не указан → спросить у человека до написания сценария.

Один пользователь (в секции Контекст:):

Дано Я запускаю тест-клиент для пользователя "SalesManager" с паролем "123" или подключаю уже существующий

Несколько пользователей (в теле сценария — именованные TestClient):

И я подключаю TestClient "Менеджер" логин "SalesManager" пароль "123"
И я подключаю TestClient "Руководитель" логин "Director" пароль "456"
 
И я активизирую TestClient "Менеджер"
# ... шаги от имени менеджера ...
 
И я активизирую TestClient "Руководитель"
# ... шаги от имени руководителя ...
 
И я закрываю TestClient "Менеджер"
И я закрываю TestClient "Руководитель"

Пароль — plain text в feature-файле. Тестовые пользователи должны иметь простой или пустой пароль (пароль "").

Двухсессийный сплит (MUST)

.feature-файл логически делится на две части:

1. Setup / инфраструктура — выполняется под техническим пользователем (AgentAI в этом проекте): подготовка тестовых данных (создание документов, элементов справочников, записей регистров), шаги VAExtension (Расширение), BSL-фикстуры из vanessa-tests/support/, всё что требует технических ролей вне нормального доступа бизнес-пользователя.
2. Бизнес-флоу (верификация) — выполняется под конкретным бизнес-пользователем (например Gavrilova Natalia для OC-23400): только шаги, проверяющие пользовательское поведение под тестом. Бизнес-пользователь НЕ должен получать технические роли (например роли из VAExtension.cfe) лишь ради прохождения шага.

Переключение сессий:

И я закрываю сеанс TESTCLIENT

или

И я закрываю TestClient "<имя>"

после чего открывается новая сессия:

Дано я подключаю TestClient "<роль>" логин "<пользователь>" пароль "<пароль>"

Обоснование (Infostart id=249957, id=249958): если бизнес-флоу выполняется с полными правами, тест перестаёт проверять реальные ролевые ограничения и даёт ложное ощущение правильности. Выдача бизнес-пользователю технических ролей ради удовлетворения инфраструктурного шага — это тот же антипаттерн в другой форме.

Антипаттерн: помещать шаги (Расширение) / фикстуры в сессию бизнес-пользователя, а потом «починить» падение выдачей ему технических ролей. Вместо этого — переместить шаг в блок setup под техническим пользователем.

Поиск шагов

Библиотека: /opt/onescript/2.0.0/lib/add/features/libraries/

Шпаргалка частых шагов с синтаксисом → references/steps-cheatsheet.md.

Полная библиотека: references/steps.json (1116 шагов). Не читай целиком — используй grep для поиска по ключевым словам из задачи. Структура каждой записи:

• ИмяШага — пример вызова с параметрами
• ОписаниеШага — что делает шаг
• ПолныйТипШага — категория (UI, Прочее, Файлы, Переменные и т.д.)

Теги

Антипаттерны

depends_on:

• framework/rules/vanessa-scenario-policy.mdc
• framework/rules/vanessa-test-isolation-policy.mdc
• framework/rules/vanessa-tests-location.mdc
• framework/rules/vanessa-run-loop.mdc
• framework/skills/tool-usage/vanessa/vanessa-diagnostics/SKILL.md
• framework/skills/tool-usage/platform-data/xml-generation/SKILL.md

requires:

• tools