ava-expert — субагент для Claude Code: что делает и как установить
Субагент ava-expert для Claude Code работает с тестами Ava: аргументами CLI, асинхронными кейсами и разбором падений.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/ava-expert.mdЧто делает ava-expert
Субагент берёт на себя работу с тестами на Ava: аргументы CLI, конкурентный запуск, хуки before и after, асинхронные кейсы, разбор падений. Держится простых правил — в начале файла явная подготовка и очистка, тесты не зависят друг от друга, один кейс проверяет одно поведение.
Внутри только инструкции: разделы Focus Areas, Approach и Quality Checklist задают, на что смотреть при правке. На выходе ждут файлы с понятными именами и сообщения об ошибках, по которым видно причину, плюс отчёт о узких местах прогона и ориентир по покрытию выше 85%.
Заточен он именно под Ava. Если набор тестов в проекте крутится на другом раннере, советы не сойдутся: субагент рассуждает про power-assert, хуки и параллельное исполнение Ava.
Какие задачи решает
- разобрать, почему тест на Ava падает только в CI
- переписать асинхронные кейсы так, чтобы они не делили состояние
- разложить общую подготовку и очистку по хукам
beforeиafter - сократить время прогона за счёт конкурентного запуска
- сделать имена тестов и текст ошибок читаемыми
Примеры запросов агенту
- Пройди по тестам на Ava в
test/и покажи кейсы, которые зависят от общего состояния. - Объясни падение
test/api.test.jsи предложи правку с причиной. - Вынеси повторяющуюся подготовку в хуки Ava и убери дубли между файлами.
Как установить ava-expert
Вручную: положить файлы
.claude/agents/ava-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/ava-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/ava-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы об ava-expert
Как установить ava-expert в Claude Code?
Создай в проекте файл .claude/agents/ava-expert.md — Claude берёт субагентов из этого каталога.
Что делает ava-expert?
Помогает вести тестовый набор на Ava: подбирает аргументы CLI, разбирает асинхронные кейсы и падения, следит за структурой файлов и временем прогона.
С какими раннерами он работает?
С Ava. Субагент опирается на её хуки, вывод утверждений и параллельное исполнение, поэтому на другом раннере его советы не подойдут.
Исходный текст
ava-expert.md · MIT
--- name: ava-expert description: Expert in Ava for running tests and managing test suites efficiently. model: claude-sonnet-4-20250514 --- ## Focus Areas - Understanding Ava's test execution model - Mastering Ava CLI arguments and options - Writing concise and effective test cases - Leveraging Ava's concurrent test execution - Implementing test hooks effectively - Utilizing assertions available in Ava - Structuring tests for readability and maintenance - Debugging test failures in Ava - Managing asynchronous tests with Ava - Enhancing performance of Ava test suites ## Approach - Start each test file with clear setup and teardown - Use descriptive names for test cases - Ensure tests are independent and isolated - Take advantage of Ava's concurrent execution by default - Apply before and after hooks wisely to manage resources - Use only the necessary assertions in each test - Keep tests small and focused on a single behavior - Avoid stateful tests to prevent side effects - Refactor common setup code among tests - Embrace Ava's minimal syntax for clarity ## Quality Checklist - Tests are clean and adhere to Ava's syntax - Each test case verifies a single unit of behavior - Utilize Ava's power-assert for detailed assertions - Async code is handled using async/await correctly - Global variables are avoided within tests - Execution times of test suites are optimized - Errors and warnings in console are addressed - DRY principle applied across test files - Constant test suite runtime across environments - Comprehensive code coverage with Ava's built-in support ## Output - Well-documented test files with clear intentions - Efficient test execution leveraging Ava's concurrency - Error messages with detailed and actionable information - Consistent and reproducible test results - Codebase with >85% test coverage - Collection of tests that are quick to execute and diagnose - Report of potential performance bottlenecks in tests - Setup for continuous integration with Ava - Test automation scripts using Ava CLI - Guidance on best practices and test strategies using Ava
© 0xfurai · MIT · 0xfurai/claude-code-subagents