feat: add rsdoctor-analysis skill (#5)

Co-authored-by: Timeless0911 <1604889533@qq.com>

Author: yifancong

README.md

@@ -34,6 +34,18 @@ npx skills add rstackjs/agent-skills --skill rsbuild-v2-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.
 
+## Rsdoctor Skills
+
+### rsdoctor-analysis
+
+```bash
+npx skills add rstackjs/agent-skills --skill rsdoctor-analytics
+```
+
+Analyze Rspack/Webpack bundles from local Rsdoctor build data. Zero-dependency JS CLI for chunk/module/package/loader insights. Provides evidence-based conclusions and actionable optimization recommendations.
+
+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.
+
 ## License
 
 MIT licensed.

packages/rsdoctor-analysis/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "rsdoctor-analysis",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "build": "rslib build",
+    "dev": "rslib build --watch"
+  },
+  "devDependencies": {
+    "@rslib/core": "^0.19.4",
+    "@types/node": "^24.10.9",
+    "commander": "^12.1.0",
+    "typescript": "^5.9.3"
+  }
+}

packages/rsdoctor-analysis/rslib.config.ts

@@ -0,0 +1,26 @@
+import { basename, join } from 'node:path';
+import { defineConfig } from '@rslib/core';
+import { baseConfig } from '@rstackjs/config/rslib.config.ts';
+
+const pkgName = basename(import.meta.dirname);
+
+export default defineConfig({
+  lib: [
+    {
+      ...baseConfig,
+      source: {
+        entry: {
+          rsdoctor: './src/index.ts',
+        },
+      },
+      banner: {
+        js: '#!/usr/bin/env node',
+      },
+      output: {
+        distPath: join(import.meta.dirname, `../../skills/${pkgName}/scripts`),
+        legalComments: 'none',
+        cleanDistPath: true,
+      },
+    },
+  ],
+});

packages/rsdoctor-analysis/src/command.ts

@@ -0,0 +1,77 @@
+import { Command } from 'commander';
+import { registerAssetCommands } from './commands/assets';
+import { registerBuildCommands } from './commands/build';
+import { registerChunkCommands } from './commands/chunks';
+import { registerErrorCommands } from './commands/errors';
+import { registerLoaderCommands } from './commands/loaders';
+import { registerModuleCommands } from './commands/modules';
+import { registerPackageCommands } from './commands/packages';
+import { registerRuleCommands } from './commands/rules';
+import { registerServerCommands } from './commands/server';
+import { closeAllSockets } from './socket';
+import { printResult } from './utils/cli-utils';
+
+export const program = new Command();
+program
+  .name('rsdoctor-skill')
+  .description('Rsdoctor skill CLI')
+  .option('--data-file <path>', 'Path to rsdoctor-data.json file (required)')
+  .option('--compact', 'Compact JSON output')
+  .showHelpAfterError()
+  .showSuggestionAfterError();
+
+export const execute = async (
+  handler: () => Promise<unknown>,
+): Promise<void> => {
+  // Parse compact option once at the beginning
+  const opts = program.opts<{ compact?: boolean | string }>();
+  const compact = opts.compact === true || opts.compact === 'true';
+  const spacing = compact ? 0 : 2;
+
+  try {
+    const result = await handler();
+    // Format result similar to old format
+    if (result && typeof result === 'object' && 'ok' in result) {
+      console.log(JSON.stringify(result, null, spacing));
+      if (!(result as { ok: boolean }).ok) {
+        process.exit(1);
+      }
+    } else {
+      printResult(result, compact);
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.log(
+      JSON.stringify(
+        {
+          ok: false,
+          error: message,
+        },
+        null,
+        spacing,
+      ),
+    );
+    process.exit(1);
+  }
+};
+
+// Register all command groups
+registerChunkCommands(program, execute);
+registerModuleCommands(program, execute);
+registerPackageCommands(program, execute);
+registerRuleCommands(program, execute);
+registerAssetCommands(program, execute);
+registerLoaderCommands(program, execute);
+registerBuildCommands(program, execute);
+registerErrorCommands(program, execute);
+registerServerCommands(program, execute);
+
+export async function run(): Promise<void> {
+  if (process.argv.length <= 2) {
+    program.help({ error: true });
+  }
+  await program.parseAsync(process.argv);
+
+  // Cleanup
+  closeAllSockets();
+}