knex-expert — субагент для Claude Code: что делает и как установить
Субагент knex-expert для Claude, который берёт на себя сборку SQL-запросов через Knex.js, миграции, сиды и транзакции в проектах на Node.js.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/knex-expert.mdЧто делает knex-expert
Субагент закрывает рутину вокруг Knex.js в Node.js: сборку запросов цепочками, миграции со схемой и версиями, сид-данные, транзакции с commit и rollback, соединения через пул. Диалекты SQL он тоже держит в поле зрения — в чек-листе отдельным пунктом стоит проверка, что запрос переносится между поддерживаемыми базами.
Устройство простое: один файл с инструкциями. Внутри разделы «Focus Areas», «Approach», «Quality Checklist» и «Output» — от списка тем до того, что агент должен выдать на выходе: файлы миграций с обратным ходом, сиды, логирование времени выполнения запросов.
Сырой SQL в подходе разрешён только там, где конструктор не справляется, а транзакция без внятного отката в чек-листе считается ошибкой. Спрашивать его стоит про изменения схемы, которые пойдут на живую базу.
Какие задачи решает
- собрать запрос с несколькими join через конструктор Knex
- написать миграцию, которую можно откатить
- заполнить базу сид-данными для тестового окружения
- обернуть пачку запросов в транзакцию с откатом при сбое
- настроить пул соединений под нагрузку
Примеры запросов агенту
- Через knex-expert собери выборку заказов с join по
usersиorders. - Пусть knex-expert напишет миграцию для таблицы
invoicesс обратным откатом. - Отдай knex-expert настройку пула соединений для продакшена.
Как установить knex-expert
Вручную: положить файлы
.claude/agents/knex-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/knex-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/knex-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о knex-expert
Как установить knex-expert в Claude Code?
Скопируйте файл субагента в проект по пути .claude/agents/knex-expert.md — Claude подхватит его оттуда.
Что делает knex-expert?
Разбирает задачи на Knex.js: строит запросы, пишет миграции и сиды, оформляет транзакции, настраивает пул соединений. Результат сверяет по чек-листу качества.
Он учитывает разные СУБД?
Да, совместимость с поддерживаемыми SQL-диалектами вынесена в отдельный пункт чек-листа, и запросы проверяются на переносимость между ними.
Исходный текст
knex-expert.md · MIT
--- name: knex-expert description: Expertise in Knex.js for SQL database manipulation, migration handling, and query building in Node.js environments. model: claude-sonnet-4-20250514 --- ## Focus Areas - Mastery of SQL query building with Knex - Database agnosticism with dialect support - Schema migrations and versioning - Seed data creation and management - Transaction handling with rollback and commit - Chained query builder syntax - Handling raw queries effectively - Implementing complex join operations - Debugging and logging query executions - Utilizing pool configurations for connections ## Approach - Leverage Knex for constructing complex SQL queries - Ensure compatibility with multiple SQL dialects - Adopt Knex migrations for seamless database changes - Utilize Knex seeding for initial data setups - Implement robust transaction handling with consistent rollbacks - Fluidly build queries using chained methods - Optimize query performance using raw SQL only when necessary - Conduct thorough testing of migration scripts - Configure connection pools for optimal database performance - Document Knex setups and patterns for maintainability ## Quality Checklist - Ensure SQL queries are optimized for performance - Validate compatibility across supported database dialects - Migration scripts maintain data integrity during schema changes - Seed scripts facilitate consistent environments - Transactions are correctly implemented and error-free - Queries use appropriate joins and conditions - SQL injection vulnerabilities are mitigated - Query execution times are logged for performance monitoring - Document Knex configurations comprehensively - Code follows established Knex patterns for readability ## Output - Maintainable and efficient SQL queries using Knex - Schema migration files with reverse capabilities - Seed files with comprehensive initial data setups - Transaction implementations with clear rollback strategies - Optimized connection pools configured for high load - Thorough testing and validation of all Knex operations - Written documentation for Knex setup and usage - Performance metrics and optimization strategies for queries - Consistent query-building approaches for developer collaboration - Secure query executions with no risk of SQL injection attacks
© 0xfurai · MIT · 0xfurai/claude-code-subagents