vanessa-diagnostics
$
npx mdskill add SteelMorgan/1c-agent-based-dev-framework/vanessa-diagnosticsDiagnoses Vanessa Automation run failures by analyzing logs and artifacts to classify errors and trigger visual checks.
- Helps resolve issues when feature scenarios fail, artifacts are missing, or failures need classification after execution.
- Integrates with Vanessa Automation logs like va-status.json, vanessa-execution.log, and event-log for analysis.
- Decides actions based on triggers such as missing files, non-zero status codes, or specific error patterns in logs.
- Presents results through error classification tables and visual confirmations via screenshots or noVNC for GUI issues.
SKILL.md
.github/skills/vanessa-diagnosticsView on GitHub ↗
--- name: vanessa-diagnostics description: Диагностика проблем прогона Vanessa Automation. Используй, когда feature-сценарий не прошёл, артефакты не создались или нужно классифицировать сбой после запуска. --- # Диагностика Vanessa Automation ## Когда применять | Триггер | Действие | |---------|----------| | `va-status.json` не создан | Считать запуск аварийным, идти в диагностику | | `va-status.json != 0` | Читать артефакты и классифицировать падение | | `vanessa-execution.log` содержит ошибку | Определить класс ошибки | | Подозрение на блокировку GUI | Визуальная диагностика | --- ## Обязательный порядок диагностики 1. Проверить `va-status.json`. 2. Проверить `vanessa-execution.log`. 3. Проверить `event-log`: сначала последние `Error`; если пусто — без фильтра уровня. 4. Если сигнал на модальное окно / security warning — `gui-control` / `screenshot`. 5. Только если недостаточно — `tech-log-analysis`. ### Special-case: `Предупреждение безопасности` Если в `event-log` запись о `Предупреждение безопасности` для `bddRunner.epf` или плагинов: 1. Считать триггером на визуальную проверку. 2. Открыть реальный экран через noVNC или снять скриншот (не полагаться на заголовки X11-окон). 3. Только после визуального подтверждения трактовать повторный запуск. --- ## Классы ошибок | Класс | Когда ставить | |-------|---------------| | `scenario_error` | Сценарий неверно сформулирован или использует неподходящий поток | | `step_resolution_error` | Нужный шаг не найден или не резолвится | | `assertion_error` | Шаги выполнились, проверка результата не совпала | | `test_data_error` | Зависит от отсутствующих/неподходящих данных | | `environment_error` | Проблема в X11, окружении, runner, запуске клиента | | `product_ui_error` | Ошибка видимого поведения формы или UI-потока | | `product_logic_error` | Бизнес-логика даёт неверный результат при корректном сценарии | ### Быстрая эвристика | Сигнал | Класс | |--------|-------| | Нет `va-status.json`, GTK/X11 error | `environment_error` | | Не найден шаг | `step_resolution_error` | | Форма открылась, ожидание не совпало | `assertion_error` / `product_ui_error` | | Ошибка из бизнес-модуля в ЖР | `product_logic_error` | | Документ/объект не найден | `test_data_error` | --- ## Результат диагностики Агент должен сообщить: класс ошибки, главный источник сигнала, следующий контур действий. ```text failure_type = test_data_error main_signal = document not found in event log / form flow next_action = choose another fixture or prepare stable test data ``` --- depends_on: - framework/rules/vanessa-diagnostics-policy.mdc - framework/rules/vanessa-security-warning.mdc - framework/skills/tool-usage/diagnostics/event-log-analysis/SKILL.md - framework/skills/tool-usage/diagnostics/tech-log-analysis/SKILL.md - framework/skills/tool-usage/browser-ui/gui-control/SKILL.md - framework/skills/tool-usage/browser-ui/screenshot/SKILL.md ---