Merge branch 'main' into chore/rsdoctor-skills-fix

yifancong · web-flow · commit 992b7425891d · 2026-02-10T12:01:51.000+08:00
diff --git a/README.md b/README.md
@@ -1,51 +1,66 @@
 # Agent Skills
 
-A collection of Agent Skills for [Rstack](https://rspack.rs/guide/start/ecosystem#rstack).
+<p>
+  <a href="https://discord.gg/XsaKEEk4mW"><img src="https://img.shields.io/badge/chat-discord-blue?style=flat-square&logo=discord&colorA=564341&colorB=EDED91" alt="discord channel" /></a>
+  <a href="https://github.com/rstackjs/agent-skills/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square&colorA=564341&colorB=EDED91" alt="license" /></a>
+  <a href="https://github.com/rstackjs/agent-skills"><img src="https://img.shields.io/github/stars/rstackjs/agent-skills?style=flat-square&colorA=564341&colorB=EDED91" alt="stars" /></a>
+  <a href="https://github.com/rstackjs/agent-skills/issues"><img src="https://img.shields.io/github/issues/rstackjs/agent-skills?style=flat-square&colorA=564341&colorB=EDED91" alt="issues" /></a>
+</p>
 
-## Rspack Skills
+A collection of Agent Skills for [Rstack](https://rspack.rs/guide/start/ecosystem#rstack).
 
-### rspack-debugging
+> AI-powered skills for debugging, tracing, upgrading, and analyzing Rstack projects.
 
-```bash
-npx skills add rstackjs/agent-skills --skill rspack-debugging
-```
+## Table of Contents
 
-Helps Rspack users and developers debug crashes or deadlocks/hangs in the Rspack build process using LLDB.
+- [Usage](#usage)
+- [Skills](#skills)
+  - [Rspack](#rspack)
+  - [Rsbuild](#rsbuild)
+  - [Rspress](#rspress)
+  - [Rsdoctor](#rsdoctor)
+- [Contributing](#contributing)
+- [License](#license)
 
-Use this Skill when users encounter "Segmentation fault" errors during Rspack builds or when the build progress gets stuck.
+## Usage
 
-### rspack-tracing
+Install any skill with:
 
 ```bash
-npx skills add rstackjs/agent-skills --skill rspack-tracing
+npx skills add rstackjs/agent-skills --skill <skill-name>
 ```
 
-Comprehensive guide and toolkit for diagnosing Rspack build issues. Quickly identify where crashes/errors occur, or perform detailed performance profiling to resolve bottlenecks.
+## Skills
 
-Use when the user encounters build failures, slow builds, or wants to optimize Rspack performance.
+### Rspack
 
-## Rsbuild Skills
+| Skill              | Description                                                                      | Use When                                                 |
+| ------------------ | -------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| `rspack-debugging` | Debug crashes or deadlocks/hangs in Rspack builds using LLDB                     | Encountering "Segmentation fault" errors or build hangs  |
+| `rspack-tracing`   | Diagnose Rspack build issues with crash identification and performance profiling | Build failures, slow builds, or performance optimization |
 
-### rsbuild-v2-upgrade
+### Rsbuild
 
-```bash
-npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade
-```
+| Skill                | Description                            | Use When                                                               |
+| -------------------- | -------------------------------------- | ---------------------------------------------------------------------- |
+| `rsbuild-v2-upgrade` | Migrate Rsbuild projects from v1 to v2 | Upgrading Rsbuild, updating configs/plugins, or validating the upgrade |
 
-Migrate Rsbuild projects from v1 to v2. Use when a user asks to upgrade Rsbuild, follow the v1-to-v2 guide, update configs/plugins, or validate the upgrade.
+### Rspress
 
-## Rsdoctor Skills
+| Skill                | Description                            | Use When                                                                       |
+| -------------------- | -------------------------------------- | ------------------------------------------------------------------------------ |
+| `rspress-v2-upgrade` | Migrate Rspress projects from v1 to v2 | Upgrading Rspress, updating packages/configs/themes, or validating the upgrade |
 
-### rsdoctor-analysis
+### Rsdoctor
 
-```bash
-npx skills add rstackjs/agent-skills --skill rsdoctor-analysis
-```
+| Skill               | Description                                                   | Use When                                                                                                         |
+| ------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `rsdoctor-analysis` | Analyze Rspack/Webpack bundles for insights and optimizations | Analyzing bundle composition, duplicates, large chunks, side-effect modules, or for optimization recommendations |
 
-Analyze Rspack/Webpack bundles from local Rsdoctor build data. Provides intelligent analysis of chunk, module, package, and loader data. Provides evidence-based conclusions and actionable optimization recommendations.
+## Contributing
 
-Use when you need to analyze bundle composition, identify duplicate packages, detect similar packages, find large chunks, analyze side effects modules, or get comprehensive bundle optimization recommendations.
+Contributions are welcome! Feel free to open an [issue](https://github.com/rstackjs/agent-skills/issues) or submit a [pull request](https://github.com/rstackjs/agent-skills/pulls).
 
 ## License
 
-MIT licensed.
+[MIT](./LICENSE)
diff --git a/packages/rsdoctor-analysis/rslib.config.ts b/packages/rsdoctor-analysis/rslib.config.ts
@@ -21,6 +21,13 @@ export default defineConfig({
         legalComments: 'none',
         cleanDistPath: true,
       },
+      tools: {
+        rspack: {
+          optimization: {
+            runtimeChunk: false,
+          },
+        },
+      },
     },
   ],
 });
diff --git a/skills/rsdoctor-analysis/scripts/rsdoctor.js b/skills/rsdoctor-analysis/scripts/rsdoctor.js
@@ -4,7 +4,23 @@ import * as __rspack_external_node_events_0a6aefe7 from "node:events";
 import * as __rspack_external_node_fs_5ea92f0c from "node:fs";
 import * as __rspack_external_node_path_c5b9b54f from "node:path";
 import * as __rspack_external_node_process_786449bf from "node:process";
-import { __webpack_require__ } from "./rslib-runtime.js";
+var __webpack_modules__ = {};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    return module.exports;
+}
+__webpack_require__.m = __webpack_modules__;
+(()=>{
+    __webpack_require__.add = function(modules) {
+        Object.assign(__webpack_require__.m, modules);
+    };
+})();
 __webpack_require__.add({
     "node:child_process" (module) {
         module.exports = __rspack_external_node_child_process_27f17141;
@@ -2950,3 +2966,4 @@ run().catch((error)=>{
     console.error(message);
     process.exit(1);
 });
+export { __webpack_require__ };
diff --git a/skills/rsdoctor-analysis/scripts/rslib-runtime.js b/skills/rsdoctor-analysis/scripts/rslib-runtime.js
diff --git a/skills/rspress-v2-upgrade/SKILL.md b/skills/rspress-v2-upgrade/SKILL.md
@@ -0,0 +1,37 @@
+---
+name: rspress-v2-upgrade
+description: Migrate Rspress projects from v1 to v2. Use when a user asks to upgrade Rspress, follow the v1-to-v2 guide, update configs/themes, or validate the upgrade.
+---
+
+# Rspress v1 to v2 Upgrade
+
+## Workflow
+
+1. **Confirm current setup**
+   - Read `package.json` to identify Rspress and plugin packages in use.
+   - Locate the Rspress config file (commonly `rspress.config.(ts|js|mjs|cjs)`).
+   - Check for custom theme files and MDX usage.
+
+2. **Open the official upgrade guide**
+   - Use the v1 → v2 guide as the source of truth:
+     - <https://rspress.rs/guide/migration/rspress-1-x>
+
+3. **Plan the upgrade path**
+   - List breaking changes that apply to the project's current config, plugins, and theme.
+   - Note any removed or renamed packages, options, and APIs.
+
+4. **Update dependencies**
+   - Replace `rspress` with `@rspress/core@^2.0.0`.
+   - Remove packages now built into `@rspress/core` (e.g. `rspress`, `@rspress/plugin-shiki`, `@rspress/plugin-auto-nav-sidebar`, `@rspress/plugin-container-syntax`, `@rspress/plugin-last-updated`, `@rspress/plugin-medium-zoom`, `@rspress/theme-default`, `@rspress/runtime`).
+   - Bump remaining Rspress plugins to latest versions via `npx taze major --include /rspress/ -w -r`.
+   - Ensure Node.js >= 20.9.0.
+
+5. **Apply config and code changes**
+   - Update import paths (`rspress/runtime` → `@rspress/core/runtime`, `rspress/theme` → `@rspress/core/theme`, `@rspress/theme-default` → `@rspress/core/theme-original`).
+   - If the project has a custom theme (in `theme` directory), use `@rspress/core/theme-original` to import the original theme components.
+   - Update the Rspress config to match v2 options and defaults.
+   - Remove deprecated or unsupported settings.
+
+6. **Validate**
+   - Run the build and dev server.
+   - Fix any warnings or errors that appear in the new version. If errors or warnings occur, please refer to the [Official Upgrade Guide](https://rspress.rs/guide/migration/rspress-1-x) and first check if it's caused by any omitted or incomplete migration steps.
