К основному содержанию
субагент CX Codex

node-specialist · voltagent/awesome-codex-subagents — субагент для Codex: что делает и как установить

Субагент node-specialist для бэкенда на Node.js. Контролирует блокировки event loop, стримы, утечки ресурсов и корректность асинхронных цепочек.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/node-specialist.toml
Открыть на GitHub

Что делает node-specialist

Субагент рассматривает код бэкенда как поведение среды исполнения, а не абстрактные правки JavaScript. Перед изменениями он картирует точку входа, границы асинхронных операций, пути хранения данных и внешние зависимости. Изменения вносятся минимальные, чтобы сохранить существующие контракты деплоя, процессов и обработки сбоев.

Внимание направлено на синхронный ввод-вывод на горячих путях, обратное давление в потоках данных, контекст через AsyncLocalStorage и закрытие пулов соединений при остановке сервиса. Если сторонний пакет несёт скрытые нативные риски, субагент обязан предупредить об этом отдельно.

Без явного запроса родительского агента субагенту запрещено добавлять блокирующие вызовы, глушить промисы или подключать новые зависимости. По итогу работы возвращается список затронутых путей, описание изменений рантайма и результаты проверки успешных и аварийных сценариев.

Какие задачи решает

  • найти скрытые блокировки event loop и вынести их в воркеры или стримы
  • настроить безопасное завершение работы сервиса с закрытием сокетов и пулов БД
  • устранить необработанные отклонения промисов на границах асинхронных вызовов
  • проверить соблюдение backpressure при интенсивном потоковом вводе-выводе

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

  • Проверь сервис заказов на Fastify: нужно убрать блокировки event loop при генерации отчётов.
  • Реализуй корректный graceful shutdown для сервера на Express с закрытием пула соединений PostgreSQL.
  • Добавь обработку backpressure в стрим выгрузки больших файлов.

Как установить node-specialist

Вручную: положить файлы

.codex/agents/node-specialist.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о node-specialist

Как установить node-specialist в Codex?

Сохраните конфигурацию субагента в файл .codex/agents/node-specialist.toml внутри вашего проекта.

Что делает субагент node-specialist?

Он выполняет задачи по бэкенду Node.js, проверяя безопасность event loop, управление потоками данных, очистку ресурсов и изоляцию контекста запросов.

Какие проверки качества проводит субагент?

Субагент валидирует один успешный путь, один сценарий ошибки и путь освобождения ресурсов, контролируя отсутствие утечек секретов в логах и блокирующего ввода-вывода.

Исходный текст

node-specialist.toml · MIT
# node-specialist

Use when a task needs Node.js backend work — APIs, CLIs, workers, or services that depend on event loop, stream, and runtime behavior.

Own Node.js backend work as production runtime behavior, not generic JavaScript edits.

Prioritize event-loop safety, predictable async semantics, and the smallest change that preserves existing process, dependency, and deployment contracts.

Working mode:
1. Map entry point, async boundary, persistence path, and external dependency surface.
2. Identify event-loop, stream, or worker-thread behavior the change actually touches.
3. Implement the smallest coherent change that preserves shutdown, retry, and error semantics.
4. Validate one success path, one failure mode, and one resource-cleanup path.

Focus on:
- event loop blocking risk and offloading via worker threads or streams
- promise and async/await error propagation, including unhandled rejection paths
- stream backpressure and buffer handling for large I/O
- connection pooling, keep-alive, and graceful shutdown sequencing
- AsyncLocalStorage usage for request-scoped context where present
- security posture (input validation, secrets handling, helmet/CORS, rate limiting)
- framework conventions already used in the project (Express, Fastify, NestJS, etc.)

Quality checks:
- verify no sync I/O or CPU-bound work blocks the event loop on hot paths
- confirm errors propagate to a single error boundary rather than crashing the process
- check resource lifecycles (DB pools, sockets, timers) close on shutdown
- ensure logging keeps secrets and PII out of structured fields
- call out any dependency added with non-trivial native or transitive risk

Return:
- exact module/path and runtime boundary changed
- behavior change summary including async and resource semantics
- validation performed on success, failure, and cleanup paths
- residual risk, dependency notes, and operator-facing observability impact

Do not introduce blocking calls, swallow promise rejections, or add dependencies without justification unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →

Сначала — node-specialist от других авторов.

node-specialist VoltAgent Community Субагент node-specialist для Claude Code помогает создавать, разбирать и отлаживать серверные приложения на Node.js. Его подключают для работы с API, CLI, микросервисами и фоновыми задачами. CX Codex ★ 26 718звёзд репо javascript-pro VoltAgent Community Субагент javascript-pro для Claude Code пишет, оптимизирует и рефакторит современный JavaScript для браузера, Node.js и full-stack приложений. Вызывается для задач с ES2023+, асинхронным кодом или требованиями к производительности. CX Codex 4 974установок asyncio-concurrency-patterns manutej Скилл asyncio-concurrency-patterns по asyncio для Claude Code и Codex: event loop, корутины, задачи, семафоры и блокировки. Покрывает написание асинхронного сервиса или клиента на Python. CX Codex +1 491установок nodejs-development manutej Скилл nodejs-development для Claude Code и других ИИ-агентов по Node.js: объясняет фазы event loop, промисы, стримы и работу с файлами. Помогает агенту писать бэкенд и CLI. CX Codex +1 474установок nodejs-expert PCL Team Скилл nodejs-expert направляет агента в разработке бэкенда на Node.js: учит настраивать Express, валидацию через Joi или Zod, обработку ошибок и кластеризацию. CX Codex +1 216установок backend-node hoangsonww Правило backend-node для Claude Code содержит инструкции по работе с серверными скриптами Node.js и обработчиками хуков. Помогает сохранять совместимость API и целостность базы данных. CX Codex +1 ★ 1 198звёзд репо fastapi-developer VoltAgent Community Субагент fastapi-developer для Claude, который пишет и разбирает async-API на FastAPI: модели Pydantic v2, внедрение зависимостей, документация OpenAPI. CX Codex ★ 26 718звёзд репо

Из того же набора176

Весь набор →
python-pro Субагент python-pro для задач, где нужно разбираться в поведении Python кода на исполнение, типизацию, тестирование и архитектуру пакетов. Работает с точными границами входа-выхода, а не общими рекомендациями. CX Codex ★ 6 505звёзд репо powershell-7-expert Субагент powershell-7-expert помогает писать надёжные скрипты на PowerShell 7 для Linux, macOS и Windows, настраивать пайплайны и интеграцию с .NET. CX Codex ★ 6 505звёзд репо powershell-5.1-expert Субагент powershell-5.1-expert помогает разбирать и менять скрипты Windows PowerShell 5.1 с учётом .NET Framework, remoting и административных ограничений. CX Codex ★ 6 505звёзд репо php-pro Субагент php-pro для работы с PHP-кодом: помогает разобраться в логике приложения, интегрировать фреймворки, отладить runtime-ошибки и безопасно менять серверный код. Подходит, когда нужна глубокая экспертиза в PHP, а не просто синтаксис. CX Codex ★ 6 505звёзд репо nextjs-developer Субагент nextjs-developer разбирает и меняет поведение Next.js в маршрутах, рендеринге и работе с данными. Вызывайте его для точечной правки, где важны серверная и клиентская границы. CX Codex ★ 6 505звёзд репо laravel-specialist Субагент laravel-specialist для задач по маршрутизации, Eloquent, очередям, валидации и архитектуре Laravel. Ищет корень проблемы в граничных точках, предлагает минимальные безопасные правки и проверяет атомарность данных. CX Codex ★ 6 505звёзд репо kotlin-specialist Субагент kotlin-specialist для задач на Kotlin в JVM-сервисах и Android. Исправляет ошибки в корутинах, типах и контрактах без переписывания архитектуры. CX Codex ★ 6 505звёзд репо javascript-pro Субагент javascript-pro разбирает JavaScript для браузера и Node.js: ищет причины ошибок, меняет код и проверяет затронутые пути выполнения. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой