---
name: vrunner-report-allure
description: Сборка единого Allure-отчёта по результатам тестирования и его открытие в браузере
---

# Навык: Единый Allure-отчёт (vrunner-report-allure)

## Назначение

Оборачивает задачу VS Code «Собрать результаты тестирования в единый отчет
и показать» из [.vscode/tasks.json](../../../.vscode/tasks.json): скрипт
[script/vrunner_report_allure.os](script/vrunner_report_allure.os):

1. генерирует единый отчёт из результатов прогонов
   (`allure generate build/out/syntax-check/allure build/out/smoke/allure
   build/out/allure -c -o build/allure-report`) — ГЕНЕРИРУЕТ артефакт
   `./build/allure-report`;
2. открывает его в браузере (`allure open`) в ОТДЕЛЬНОМ окне, чтобы не
   заблокировать терминал веб-сервером Allure.

Использует внешний CLI `allure` (не vrunner) — он должен быть установлен и
доступен в PATH.

## Когда применять

- Тесты (Vanessa/YAxUnit/xUnit/синтаксический контроль) уже прогнаны и в
  `build/out/*/allure` есть результаты; пользователь хочет свести их в один
  отчёт и посмотреть.
- Вызвана команда `/vrunner-report-allure`.

НЕ применять до прогона тестов — без результатов в `build/out/*/allure`
генерация завершится ошибкой (нечего собирать).

## Обязательный диалог перед запуском скрипта

Параметры не требуются. Уточнять ничего не нужно; при желании — напомнить
пользователю, что отчёт открывается в отдельном окне (веб-сервер Allure),
которое нужно будет закрыть вручную.

## Запуск

Из корня репозитория (предпочтительно через PowerShell):

```
oscript .claude/skills/vrunner-report-allure/script/vrunner_report_allure.os
```

## Что делает скрипт

1. Проверяет наличие CLI `allure` (`allure --version`).
2. `allure generate ... -c -o build/allure-report` и проверяет, что каталог
   отчёта создан.
3. Запускает `allure open build/allure-report` в отдельном окне (detached).

## Интерпретация результатов

- **Exit code 0** — отчёт собран в `./build/allure-report`, его открытие
  запущено в отдельном окне. Сообщить путь и напомнить закрыть окно/сервер
  после просмотра.
- **Exit code 1, нет CLI allure** — сообщить, что нужен Allure Commandline в
  PATH (ссылка на установку — в выводе скрипта).
- **Exit code 1, генерация не удалась** — типичная причина: нет результатов
  в `build/out/*/allure` (тесты не прогонялись). Предложить сначала прогнать
  тесты соответствующими `vrunner-test-*` навыками.

## Ограничения

- Зависит от внешнего `allure` CLI (не входит в OScript-модули проекта).
- `allure open` поднимает локальный веб-сервер; скрипт запускает его
  detached (в отдельном окне), пользователь закрывает его сам.
- Отчёт строится по УЖЕ существующим результатам в `build/out/*/allure` —
  навык их не прогоняет, только агрегирует.