vanessa-diagnostics

$npx mdskill add SteelMorgan/1c-agent-based-dev-framework/vanessa-diagnostics

Diagnoses 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
---
More from SteelMorgan/1c-agent-based-dev-framework