Vanessa_for_AI

Установка

python tools/build_steps_catalog.py `
  --source .\vendor\vanessa-automation `
  --version 1.2.043.28 `
  --commit f3a01778a14d29b38204685deea0131274d438ff `
  --output knowledge/vanessa-automation/steps-library.json

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Набор учит агента писать и чинить русскоязычные .feature-сценарии для Vanessa Automation, не подключая MCP и не заходя в интерфейс 1С. Скилл vanessa-project-bootstrap изучает репозиторий и предлагает минимальную структуру каталогов, но создает ее только после согласования. Скилл vanessa-feature-authoring строит сценарий по записи действий пользователя, разделяет подготовку, действие, проверки и очистку, расставляет ожидания и сверяет шаги с локальным каталогом. Каталог шагов собран из исходников Vanessa Automation и пересобирается скриптом под нужную версию.

Для кого. Для разработчиков и тестировщиков 1С, которые автоматизируют UI-тесты в Vanessa Automation.

Пример запроса к агенту

Используй vanessa-feature-authoring: вот запись Vanessa, нужно проверить, что документ поступления проводится и остаток увеличивается

Ограничения

Нужны установленные 1С:Предприятие, Vanessa Automation, TestClient и тестовая база. Агент не запускает сценарии: прогон делает пользователь и возвращает результат. Встроенный каталог шагов собран для версии 1.2.043.28 и не подтверждает имена окон и элементов конкретной конфигурации. Правила и скиллы распространяются по CC BY 4.0 с требованием атрибуции.

Как отключить. Удалите из проекта скопированные AGENTS.md, CLAUDE.md, каталоги .agents/skills и .claude/skills с этими скиллами и knowledge/vanessa-automation.

Проверка безопасности

• Набор состоит из правил, инструкций и справочника шагов
• Агент меняет только файлы сценариев и не подключается к 1С

Коротко о README

README объясняет, что проект работает только с файлами и не требует MCP, и перечисляет состав: общие правила, два скилла, каталог шагов и скрипт его сборки. Описан быстрый старт через GitHub Template и подключение к существующему проекту копированием файлов. Таблица показывает, как вызывать скиллы в Codex, Claude Code и OpenCode. Отдельно описан порядок выбора источника шагов и честный цикл, в котором прогон выполняет человек. Лицензия CC BY 4.0, каталог шагов под BSD-3-Clause.

SKILL.md

---
name: vanessa-feature-authoring
description: Создаёт, изменяет, проверяет и диагностирует русскоязычные Turbo Gherkin `.feature` для Vanessa Automation без MCP. Используй для UI-сценариев 1С, экспортных сценариев, переменных, тестовых данных, очистки, переходов окон, ожиданий, поиска шагов в локальном каталоге и разбора runtime-ошибок. Требует запись Vanessa Automation или runtime-проверенный аналог и бизнес-цель пользователя.
---

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

Не подключай MCP. Работай с файлами проекта, локальным каталогом шагов, записью пользователя и runtime-диагностикой.

## Проверь вход

До изменения UI-шагов получи:

1. бизнес-цель;
2. ожидаемые проверки результата;
3. запись Vanessa Automation либо runtime-проверенный аналог.

Если структуры проекта нет, сначала используй `vanessa-project-bootstrap` и дождись согласования. Если не подтверждена конкретная UI-деталь, запроси минимальный фрагмент записи или диагностики до редактирования затронутых шагов.

## Собери контекст

1. Прочитай `AGENTS.md`, корневой README и ближайший README сценария.
2. Найди похожие исполняемые и экспортные сценарии.
3. Проверь точные имена вызываемых `@ExportScenarios`.
4. Определи версию Vanessa Automation и подходящий каталог шагов.
5. Составь порядок зависимостей и очистки.

Читайте references только по потребности:

- подтверждение UI-фактов — [references/ui-evidence.md](references/ui-evidence.md);
- состояния окон и ожидания — [references/window-state-and-waits.md](references/window-state-and-waits.md);
- переменные и экспортные сценарии — [references/variables-and-exports.md](references/variables-and-exports.md);
- тестовые данные и очистка — [references/data-and-cleanup.md](references/data-and-cleanup.md);
- ожидаемые ошибки и сообщения пользователю — [references/negative-messages.md](references/negative-messages.md);
- условные блоки `Если ... Тогда` — [references/conditional-blocks.md](references/conditional-blocks.md);
- каталог шагов — [references/step-catalog.md](references/step-catalog.md);
- диагностика и финальная проверка — [references/diagnostics-and-review.md](references/diagnostics-and-review.md).

## Спроектируй сценарий

1. Отдели подготовку, действие, независимые бизнес-проверки и очистку.
2. Для каждого действия, меняющего окно, запиши трассу:

   `действие -> ожидаемое активное окно -> источник факта`

Похожие