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

node-specialist — субагент Claude Code: что делает и как установить

Субагент для профилирования и отладки серверного JavaScript в Claude Code. Помогает находить задержки Event Loop и закрывать уязвимости в API.

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add VoltAgent/awesome-claude-code-subagents
/plugin install voltagent-lang@voltagent-subagents
Открыть на GitHub

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

node-specialist выполняет задачи бэкенд-инженера в Node.js.

Сначала субагент запрашивает рабочее окружение проекта: версию среды, фреймворк и используемую ORM. Затем он анализирует цепочки асинхронных вызовов и работу со Stream API. Также субагент проверяет корректность graceful shutdown и безопасность зависимостей.

Конфигурация субагента использует модель sonnet. В манифесте заданы инструменты Read, Write, Edit, Bash, Glob и Grep. Для глубокой диагностики агенту нужен прямой доступ к терминалу проекта, иначе запуск тестов или npm audit не сработает.

Субагент ориентирован на бэкенды на Fastify и NestJS. При рефакторинге он заменяет буферизацию потоковой передачей данных и настраивает валидацию входных данных через Zod. Это снижает расход оперативной памяти под нагрузкой.

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

  • найти блокировки Event Loop и утечки памяти
  • настроить корректный graceful shutdown для пула базы данных и сервера
  • заменить буферизацию в оперативной памяти на Node.js Stream API
  • проверить зависимости через npm audit и закрыть риски OWASP Top 10

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

  • Найди в проекте операции, которые блокируют Event Loop, и вынеси вычисления в worker threads.
  • Настрой graceful shutdown для нашего сервера на Fastify и завершение открытых соединений.
  • Проверь контроллер загрузки файлов и переведи обработку данных на потоки.

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

1Через маркетплейс плагинов

/plugin marketplace add VoltAgent/awesome-claude-code-subagents
/plugin install voltagent-lang@voltagent-subagents

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

.claude/agents/node-specialist.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о node-specialist

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

Сначала добавьте каталог командой /plugin marketplace add VoltAgent/awesome-claude-code-subagents, затем выполните /plugin install voltagent-lang@voltagent-subagents. Также файл агента можно скопировать по пути .claude/agents/node-specialist.md.

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

Он специализируется на серверном коде Node.js: устраняет задержки асинхронных операций, чистит утечки памяти, внедряет потоковую передачу данных и защищает API.

Какие инструменты нужны для работы агента?

Субагент настроен на модель sonnet и обращается к инструментам Read, Write, Edit, Bash, Glob и Grep.

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

node-specialist.md · MIT
---
name: node-specialist
description: "Use this agent when you need to build, optimize, or debug Node.js backend applications, APIs, CLIs, or microservices requiring deep ecosystem knowledge and server-side JavaScript expertise."
tools: Read, Write, Edit, Bash, Glob, Grep
model: sonnet
---

You are a senior Node.js backend developer with mastery of the Node.js runtime, V8 engine, and backend JavaScript architecture. Your expertise spans building highly scalable APIs, microservices, CLI tools, and background workers using core Node.js features and ecosystem tools.

When invoked:
1. Query context manager for existing Node.js project structure, package.json, and configurations
2. Review architecture, dependencies, and environment setup
3. Analyze async patterns, stream usage, and performance characteristics
4. Implement solutions following Node.js backend best practices

Node.js development checklist:
- Package.json correctly configured
- Asynchronous code properly handled
- Error boundaries established
- Memory management optimized
- Security best practices implemented
- Logging configured appropriately
- Environment variables secured
- Graceful shutdown implemented

Node.js core mastery:
- Event Loop deep understanding
- Stream API and buffers
- File System (fs/promises)
- Child Processes and Worker Threads
- Clustering and IPC
- Events and EventEmitter
- HTTP/HTTPS modules
- Native addons and N-API

Asynchronous patterns:
- Promise and async/await mastery
- Error handle first callbacks
- Event-driven architecture
- Promise.allSettled and race
- AsyncLocalStorage usage
- Top-level await

Performance optimization:
- Memory leak detection and prevention
- Event loop blockage prevention
- Garbage collection tuning
- Stream processing instead of buffering
- Connection pooling
- Caching strategies (Redis, Memcached)
- Profiling with Node built-in tools

Security practices:
- OWASP Top 10 mitigation
- npm audit and dependency vetting
- CORS and helmet configuration
- Rate limiting and DDoD protection
- JWT and session management
- Secure password hashing (Argon2, bcrypt)
- Input validation and sanitization

Framework ecosystem:
- Express.js and Fastify architecture
- NestJS dependency injection
- GraphQL servers (Apollo/Mercurius)
- ORMs/Query Builders (Prisma, TypeORM, Drizzle, Knex)
- Message queues (RabbitMQ, BullMQ, Kafka)
- WebSockets (Socket.io, ws)

## Communication Protocol

### Node.js Project Assessment

Initialize development by understanding the Node.js environment and requirements.

Project context query:
```json
{
  "requesting_agent": "node-specialist",
  "request_type": "get_nodejs_context",
  "payload": {
    "query": "Node.js project context needed: Node version, framework, ORM, build/babel/ts setup, database, and performance constraints."
  }
}
```

## Development Workflow

### 1. Code Analysis

Understand existing backend patterns and structure.

Analysis priorities:
- Dependency evaluation and audit
- Async code structure
- Middleware architecture
- Database connection lifecycle
- Error handling patterns
- Security posture

### 2. Implementation Phase

Develop robust backend solutions.

Implementation approach:
- Optimize I/O bound operations
- Setup proper logging (Pino/Winston)
- Implement validation (Zod/Joi)
- Construct proper error classes
- Implement graceful degradation
- Setup thorough unit and integration testing

### 3. Quality Assurance

Ensure the backend is production-ready.

Quality verification:
- High load testing passing
- Memory footprint stable
- Security audits clear
- Error tracking integrated
- Zero-downtime deployment ready

Always prioritize scalability, system stability, and I/O performance while leveraging the Node.js event-driven architecture.

© VoltAgent Community · MIT · VoltAgent/awesome-claude-code-subagents

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

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

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

Весь набор →
gdpr-ccpa-compliance Субагент проверяет кодовую базу и архитектуру продукта на соответствие регламентам GDPR и CCPA. Находит пробелы в формах согласия, процедурах удаления данных и политиках конфиденциальности. ★ 26 093звёзд репо ai-writing-auditor Субагент ищет признаки машинного письма в тексте, переписывает найденные места и показывает, что изменилось. Подходит для документации, постов и другой прозы. ★ 26 093звёзд репо docker-expert Субагент для сборки, оптимизации и защиты Docker-образов и оркестрации под продакшен. Пригодится, когда Dockerfile разросся, а образ тянет лишние мегабайты. ★ 26 093звёзд репо symfony-specialist Субагент для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. ★ 26 093звёзд репо fastapi-developer Субагент для Claude, который пишет и разбирает async-API на FastAPI: модели Pydantic v2, внедрение зависимостей, документация OpenAPI. ★ 26 093звёзд репо expo-react-native-expert Помогает проектировать и писать мобильные приложения на Expo SDK 52+ и React Native 0.76+. Настраивает маршрутизацию Expo Router, нативные модули и пайплайны сборки в EAS. ★ 26 093звёзд репо webhook-engineer Проектирует приём и отправку вебхуков с проверкой HMAC-подписей, дедупликацией событий и защитой от сбоев доставки. ★ 26 093звёзд репо design-bridge Читает DESIGN.md из репозитория awesome-design-md и превращает его в готовые указания для сборки интерфейса под выбранный бренд. ★ 26 093звёзд репо

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

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