Правила, Agent Skills и автономный каталог шагов для разработки сценариев Vanessa Automation с помощью Codex, Claude Code, OpenCode и других ИИ-агентов.
Important
Проект не использует и не требует MCP. Агент работает с файлами проекта, локальным каталогом шагов и материалами пользователя, но не получает доступ к интерфейсу 1С или Vanessa Automation.
Репозиторий не содержит сценариев конкретной конфигурации 1С. Он задаёт переносимый рабочий процесс: пользователь передаёт запись действий Vanessa Automation или проверенный аналог, агент исследует структуру проекта, согласует её при необходимости и только затем создаёт или изменяет сценарии.
AGENTS.md— общие правила для Codex, OpenCode и других агентов.CLAUDE.md— подключение тех же правил в Claude Code.vanessa-project-bootstrap— skill для согласования структуры чистого проекта.vanessa-feature-authoring— skill для создания, проверки и диагностики Turbo Gherkin.knowledge/vanessa-automation/steps-library.json— автономный справочник стандартных шагов Vanessa Automation.tools/build_steps_catalog.py— воспроизводимая сборка справочника из локального checkout Vanessa Automation.
До начала работы должны быть установлены и настроены:
- платформа 1С:Предприятие;
- Vanessa Automation;
- TestClient и тестовая информационная база;
- один из поддерживаемых ИИ-агентов.
Этот репозиторий не устанавливает Vanessa Automation, не запускает 1С и не подключается к тестовой базе. Официальные инструкции находятся в документации Vanessa Automation.
- Создайте проект из этого GitHub Template или клонируйте репозиторий.
- Откройте корень проекта в выбранном агенте.
- Передайте бизнес-цель, ожидаемые проверки и запись Vanessa Automation либо проверенный аналог.
- Если структуры ещё нет, попросите агента сначала применить
vanessa-project-bootstrap. - Согласуйте предложенное дерево каталогов.
- Попросите создать сценарий с помощью
vanessa-feature-authoring. - Запустите сценарий в Vanessa Automation и верните агенту результат или диагностику.
Пример запроса:
Проект пока пуст. Используй skill vanessa-project-bootstrap, предложи минимальную
структуру и дождись моего подтверждения. После этого используй
vanessa-feature-authoring. Цель проверки: <цель>. Вот запись Vanessa: <запись>.
Скопируйте в корень проекта:
AGENTS.mdили аккуратно объедините его с существующими правилами;CLAUDE.md, если используется Claude Code;.agents/skills/;.claude/skills/, если используется Claude Code;knowledge/vanessa-automation/.
Не заменяйте существующие проектные правила вслепую. Ближайшие к сценариям README и локальные соглашения должны сохранять приоритет.
| Агент | Правила | Skills | Явный вызов |
|---|---|---|---|
| Codex | AGENTS.md |
.agents/skills/ |
$vanessa-feature-authoring |
| Claude Code | CLAUDE.md → AGENTS.md |
.claude/skills/ |
/vanessa-feature-authoring |
| OpenCode | AGENTS.md |
.agents/skills/ |
через skill tool или по описанию задачи |
| Другие Agent Skills-клиенты | согласно клиенту | открытый формат SKILL.md |
согласно клиенту |
Формат skills соответствует Agent Skills Specification. Пути проверены по документации Codex, Claude Code и OpenCode.
Источники применяются в таком порядке:
- запись пользователя из текущего окружения;
- runtime-проверенный сценарий текущего проекта;
- каталог шагов, собранный для версии Vanessa Automation пользователя;
- встроенный каталог версии
1.2.043.28как справочный fallback.
Каталог подтверждает синтаксис и наличие стандартного шага в указанной версии. Он не подтверждает заголовки окон, имена элементов и колонок, навигационные ссылки или поведение конкретной конфигурации 1С.
Искать шаги следует точечно, например:
rg -n -i 'жду открытия окна' knowledge/vanessa-automation/steps-library.jsonСборка каталога для другой версии:
python tools/build_steps_catalog.py `
--source .\vendor\vanessa-automation `
--version 1.2.043.28 `
--commit f3a01778a14d29b38204685deea0131274d438ff `
--output knowledge/vanessa-automation/steps-library.jsonСкрипт читает исходные BSL-модули. Он не запускает 1С, Vanessa Automation или MCP.
- Агент не должен придумывать UI-факты и способы взаимодействия.
- Неизвестная деталь блокирует только затронутые шаги: агент запрашивает минимальную запись или диагностику.
- Создание файла не означает успешный runtime-прогон.
- Пользователь запускает сценарий в Vanessa Automation и возвращает результат агенту.
- В документацию проекта заносятся только факты, подтверждённые текущим окружением.
Локальная проверка:
python -m unittest discover -s tests -v
python tools/validate_repository.py --distributionПравила вкладов описаны в CONTRIBUTING.md.
Оригинальные правила, skills и документация Vanessa_for_AI доступны по лицензии CC BY 4.0. Каталог шагов производен от Vanessa Automation и сопровождается отдельным уведомлением BSD-3-Clause в THIRD_PARTY_NOTICES.md.
При переиспользовании укажите:
Основано на Vanessa_for_AI автора @andrejkaxz: https://github.com/andrejkaxz/Vanessa_for_AI, лицензия CC BY 4.0. Изменения: <описание>.