rspack-tracing — скилл для Claude Code: профилирование сборок Rspack
Скилл rspack-tracing для Claude Code и других IDE захватывает и анализирует traces сборок Rspack, чтобы найти медленные фазы компилятора, плагины и лоадеры. Помогает диагностировать крахи и узкие места прямо в процессе разработки.
MIT 291 установок ★ 100 обновлён 2026-10-22
npx skills add rstackjs/agent-skills --skill rspack-tracing -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/rspack-tracing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rspack-tracing/
1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspack-tracing -a codex2Вручную: положить файлы
.agents/skills/rspack-tracing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspack-tracing -a cursor2Вручную: положить файлы
.cursor/skills/rspack-tracing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rstackjs/agent-skills skills/rspack-tracing2Вручную: положить файлы
.github/skills/rspack-tracing/SKILL.md1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspack-tracing -a gemini-cli2Командой платформы
gemini skills install https://github.com/rstackjs/agent-skills --path skills/rspack-tracingВручную: положить файлы
.devin/skills/rspack-tracing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspack-tracing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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