К основному содержанию
скилл CX Codex

rspack-tracing — скилл для Claude Code: профилирование сборок Rspack

Скилл rspack-tracing для Claude Code и других IDE захватывает и анализирует traces сборок Rspack, чтобы найти медленные фазы компилятора, плагины и лоадеры. Помогает диагностировать крахи и узкие места прямо в процессе разработки.

MIT 291 установок ★ 100 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add rstackjs/agent-skills --skill rspack-tracing -a claude-code
Открыть на GitHub

Что делает rspack-tracing

Скилл проводит агента через четыре шага: сначала включает трейсинг через переменные окружения (RSPACK_PROFILE=TRACE), потом быстро смотрит последние события в файле трейса, чтобы найти крах, затем запускает анализ через встроенный скрипт analyze_trace.mjs, и в конце сопоставляет названия спанов с конкретными плагинами в конфиге.

Для диагностики падений достаточно посмотреть последние 20 строк трейса через tail. Если нужен полный анализ производительности, скрипт выдаст список самых медленных хуков и позволит найти, какой плагин за них отвечает. На выходе агент покажет пути и строки в исходнике подозрительных плагинов.

Для работы нужны Node.js и pnpm (или другой пакетный менеджер). Трейсы сохраняются в директории .rspack-profile-{timestamp}-{pid}/ с файлом trace.json внутри.

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

  • найти, почему Rspack-сборка медленная
  • определить, какой плагин или лоадер тормозит
  • выявить фазу компилятора, где произошёл крах
  • анализировать user-provided трейс-файл

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

  • Помоги мне найти, почему сборка Rspack медленная
  • Проанализируй мой trace.json и скажи, какой плагин тормозит
  • Я вижу крах при сборке — помоги понять, на какой стадии произошло

Как установить rspack-tracing

1Через Skills CLI (Vercel)

npx skills add rstackjs/agent-skills --skill rspack-tracing -a claude-code

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

~/.claude/skills/rspack-tracing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/rspack-tracing/

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

Вопросы о rspack-tracing

Как установить rspack-tracing в Claude Code?

Запусти npx skills add rstackjs/agent-skills --skill rspack-tracing -a claude-code, затем открой ~/.claude/skills/rspack-tracing/SKILL.md.

Что делает rspack-tracing?

Помогает найти медленные фазы и плагины в Rspack-сборках. Агент запускает трейсинг, анализирует лог и указывает, какой код тормозит.

Нужно ли что-то ещё для работы?

Нужны Node.js и pnpm (или npm/yarn). Скилл работает с существующим rspack.config.js или rsbuild.config.ts в проекте.

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

SKILL.md · MIT
---
name: rspack-tracing
description: Capture or analyze Rspack build traces to locate slow compiler phases, plugins, loaders, or the last events before a build failure.
---

# Rspack tracing & performance profiling

## When to use this skill

Use this skill when you need to:

1.  Diagnose why an Rspack build is slow.
2.  Understand which plugins or loaders are taking the most time.
3.  Analyze a user-provided Rspack trace file.
4.  Guide a user to capture a performance profile.

## Workflow

### 1. Capture a trace

First, ask the user to run their build with tracing enabled.

```bash
# Set environment variables for logging to a file
RSPACK_PROFILE=TRACE RSPACK_TRACE_LAYER=logger RSPACK_TRACE_OUTPUT=./trace.json pnpm build
```

This will generate a trace file in a timestamped directory like `.rspack-profile-{timestamp}-{pid}/trace.json`.

See [references/tracing-guide.md](references/tracing-guide.md) for more details on configuration.

### 2. Quick diagnosis for Crashes/Errors

If the user wants to identify **which stage a crash or error occurred in**, use `tail` to quickly view the last events without running the full analysis:

```bash
# Navigate to the generated profile directory
cd .rspack-profile-*/

# View the last 20 events to see where the build failed
tail -n 20 trace.json
```

The last events will show the span names and targets where the build stopped, helping to quickly pinpoint the problematic stage, plugin, or loader.

### 3. Full performance analysis

For detailed performance profiling (not just crash diagnosis), ask the user whether to run the bundled [`scripts/analyze_trace.mjs`](scripts/analyze_trace.mjs) on the generated trace file. If they agree, resolve it relative to the Skill root while keeping the working directory in the user's project, then run:

```bash
# Navigate to the generated profile directory
cd .rspack-profile-*/

# Run the analysis script
node "<skill-root>/scripts/analyze_trace.mjs" trace.json
```

### 4. Interpret results

Use the output from the script to identify bottlenecks.
Consult [references/bottlenecks.md](references/bottlenecks.md) to map span names to actionable fixes.

### 5. Locate slow plugins

Based on the "Top Slowest Hooks" from the analysis script:

1.  **Identify the Hook**: Note the hook name (e.g., `hook:CompilationOptimizeChunks`).
2.  **Inspect Configuration**: Read `rspack.config.js` or `rsbuild.config.ts`.
3.  **Map Hook to Plugin**: Look for plugins and their sources that tap into that specific hook.
4.  **Output**: Output the paths, lines and columns of the suspected plugin source code.

## Common scenarios & quick fixes

- [Bottleneck Reference](references/bottlenecks.md): Mapping spans to concepts.
- [Tracing Guide](references/tracing-guide.md): Detailed usage of `RSPACK_PROFILE`.

© rstackjs · MIT · rstackjs/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
memory-optimization aj-geddes Скилл memory-optimization для Claude Code, который помогает профилировать использование памяти и находить утечки. Запускается, когда приложение тормозит или падает с out of memory. CX Codex +1 554установок memory-leak-detection aj-geddes Скилл memory-leak-detection помогает найти и починить утечки памяти: heap-снимки, профилирование, разбор типичных причин роста потребления. CX Codex +1 592установок dotnet-diag Microsoft Плагин dotnet-diag для GitHub Copilot добавляет скиллы для анализа производительности .NET, отладки и разбора инцидентов. Скиллы помогают искать причины сбоев и медленной работы. ★ 6 320звёзд репо rsdoctor web-infra-dev MCP-сервер rsdoctor отдаёт агенту данные сборки Rspack: размеры ассетов, зависимости модулей, время компиляции и диагностику дублей пакетов. CX Codex +1 ★ 1 152звёзд репо performance rshankras Скилл performance диагностирует медленные приложения, зависания и утечки памяти через Instruments, а также находит лишние перерисовки и проблемы идентификации представлений в SwiftUI. CX Codex +1 212установок investigating-performance osmontero Скилл investigating-performance задаёт агенту строгий протокол поиска узких мест: запрещает менять код без замеров, требует воспроизводить нагрузку и профилировать нужный ресурс. CX Codex +1 146установок

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

Весь набор →
migrate-to-rstest Скилл migrate-to-rstest для Claude Code и Codex переносит тесты из Jest, Vitest или Playwright Test в Rstest, сохраняя обнаружение, ассерты, моки, снапшоты и покрытие. Миграция проходит без переписывания сценариев. CX Codex +1 436установок rspress-custom-theme Скилл rspress-custom-theme подсказывает агенту, как менять тему Rspress v2: от CSS-переменных до замены встроенных компонентов. CX Codex +1 435установок rspress-docs-generator Скилл rspress-docs-generator разворачивает сайт документации на Rspress v2 или обновляет существующие страницы под изменения в коде, тестах и API. CX Codex +1 344установок migrate-to-rsbuild Скилл migrate-to-rsbuild переводит фронтенд-проекты с webpack, Vite, Create React App и Vue CLI на сборщик Rsbuild. Он пошагово заменяет конфигурацию и проверяет запуск перед удалением старых пакетов. CX Codex +1 342установок rspack-debugging Скилл rspack-debugging для Claude Code снимает через LLDB состояние краша нативного Rspack и собирает бэктрейсы при segfault, дедлоке или зависшей сборке. CX Codex +1 282установок storybook-rsbuild Скилл storybook-rsbuild настраивает Storybook на Rsbuild или переносит существующий проект с webpack и Vite. Он также учитывает интеграции с Rslib, Modern.js и Rspack. CX Codex +1 212установок migrate-to-rslib Скилл migrate-to-rslib переводит сборку библиотек с tsc или tsup на Rslib с проверкой билда и сохранением исходного кода. CX Codex +1 201установок rspack-split-chunks Скилл rspack-split-chunks помогает агенту диагностировать и настраивать optimization.splitChunks в Rspack: найти дубликаты модулей, избыточную загрузку, проблемы кеширования и слишком большие чанки. CX Codex +1 187установок

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

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