pandax 0.0.1

package/README.md

@@ -0,0 +1,83 @@
+# pandax
+
+Pandax 全栈 AI 编程技能魔盒，参考 [superpowers-zh](https://www.npmjs.com/package/superpowers-zh) 的 `npx` 安装方式，将团队工程规范沉淀为可复用的 AI skills，未来还将扩展脚手架、项目模板等能力。
+
+## 安装 Skills
+
+在任意项目根目录执行：
+
+```bash
+npx pandax
+```
+
+CLI 会自动检测当前项目使用的 AI 编程工具。如果检测失败，可手动指定：
+
+```bash
+npx pandax --tool trae
+npx pandax --tool cursor
+npx pandax --tool claude
+npx pandax --tool codebuddy
+```
+
+安装完成后重启对应的 AI 编程工具即可生效。
+
+## 初始化项目模板
+
+```bash
+npx pandax --init vue3                    # 初始化 Vue3 单应用模板
+npx pandax --init pandax-monorepo       # 初始化 Monorepo + 微前端模板
+npx pandax --init vue3 --with-skills    # 初始化模板并安装 skills
+```
+
+## 卸载
+
+```bash
+npx pandax --uninstall
+```
+
+## 包含的 Skills
+
+### 前端
+
+| Skill | 说明 |
+|-------|------|
+| [pandax-frontend-architecture](skills/pandax-frontend-architecture/SKILL.md) | 设计前端项目架构与技术方案 |
+| [pandax-frontend-component-review](skills/pandax-frontend-component-review/SKILL.md) | 审查 Vue/React 组件代码 |
+| [pandax-frontend-chinese-copywriting](skills/pandax-frontend-chinese-copywriting/SKILL.md) | 检查并修正项目中的中文文案排版 |
+| [pandax-frontend-api-mock](skills/pandax-frontend-api-mock/SKILL.md) | 规范 API 对接与 Mock 数据管理 |
+| [pandax-frontend-requirement](skills/pandax-frontend-requirement/SKILL.md) | 梳理前端需求并输出可执行方案 |
+| [pandax-frontend-standards](skills/pandax-frontend-standards/SKILL.md) | 统一引用前端规范文档 |
+| [pandax-frontend-use-modal](skills/pandax-frontend-use-modal/SKILL.md) | 生成 Vue 3 + Element Plus useModal Hook |
+
+## 支持的 AI 工具
+
+- Trae
+- Cursor
+- Claude Code
+- Codex CLI
+- OpenCode
+- Cline
+- CodeBuddy
+
+## 环境要求
+
+- Node.js >= 14.0.0
+
+## 开发与发布
+
+### 本地测试
+
+```bash
+node bin/pandax.js --tool trae
+```
+
+### 发布到 npm
+
+```bash
+npm login
+npm publish --access public
+```
+
+## 参考
+
+- [superpowers-zh](https://www.npmjs.com/package/superpowers-zh)

package/bin/pandax.js

@@ -0,0 +1,592 @@
+#!/usr/bin/env node
+
+const {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  writeFileSync,
+  copyFileSync,
+  lstatSync,
+  realpathSync,
+  rmdirSync,
+  unlinkSync,
+} = require('fs');
+const { resolve, dirname, join } = require('path');
+const { homedir } = require('os');
+const PKG = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf8'));
+const SKILLS_SRC = resolve(__dirname, '..', 'skills');
+const TEMPLATES_SRC = resolve(__dirname, '..', 'templates');
+const PROJECT_DIR = process.cwd();
+
+// 手动递归复制，避免 Windows npx 缓存 junction 问题
+function copyDirSync(src, dest) {
+  let realSrc = src;
+  try { realSrc = realpathSync(src); } catch {}
+
+  mkdirSync(dest, { recursive: true });
+  const entries = readdirSync(realSrc, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === '.DS_Store') continue;
+    const srcPath = join(realSrc, entry.name);
+    const destPath = join(dest, entry.name);
+    let stat;
+    try { stat = lstatSync(srcPath); } catch { continue; }
+    if (stat.isSymbolicLink()) {
+      try {
+        const real = realpathSync(srcPath);
+        const realStat = lstatSync(real);
+        if (realStat.isDirectory()) copyDirSync(real, destPath);
+        else copyFileSync(real, destPath);
+      } catch {}
+    } else if (stat.isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else if (stat.isFile()) {
+      copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+// 兼容 Node >= 14.0.0：fs.removeSync 直到 14.14.0 才引入
+function removeSync(p) {
+  if (!existsSync(p)) return;
+  const stat = lstatSync(p);
+  if (stat.isDirectory()) {
+    for (const entry of readdirSync(p, { withFileTypes: true })) {
+      removeSync(join(p, entry.name));
+    }
+    rmdirSync(p);
+  } else {
+    unlinkSync(p);
+  }
+}
+
+function countDirs(dir) {
+  if (!existsSync(dir)) return 0;
+  return readdirSync(dir, { withFileTypes: true }).filter(e => e.isDirectory()).length;
+}
+
+function scanSkillEntries(skillsDir) {
+  const entries = [];
+  if (!existsSync(skillsDir)) return entries;
+  for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const skillFile = resolve(skillsDir, entry.name, 'SKILL.md');
+    if (!existsSync(skillFile)) continue;
+    const content = readFileSync(skillFile, 'utf8');
+    const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!fmMatch) continue;
+    const nameMatch = fmMatch[1].match(/^name:\s*(.+)$/m);
+    const categoryMatch = fmMatch[1].match(/^category:\s*(.+)$/m);
+    const descMatch = fmMatch[1].match(/^description:\s*["']?(.+?)["']?\s*$/m);
+    if (nameMatch) {
+      const stripQuotes = (s) => s.replace(/^["']|["']$/g, '');
+      entries.push({
+        name: stripQuotes(nameMatch[1].trim()),
+        category: stripQuotes((categoryMatch ? categoryMatch[1] : '通用').trim()),
+        desc: descMatch ? stripQuotes(descMatch[1].trim()) : '',
+      });
+    }
+  }
+  return entries;
+}
+
+function groupSkillsByCategory(entries) {
+  const groups = {};
+  for (const e of entries) {
+    const cat = e.category || '通用';
+    if (!groups[cat]) groups[cat] = [];
+    groups[cat].push(e);
+  }
+  return groups;
+}
+
+function categoryLabel(category) {
+  const labels = {
+    frontend: '前端',
+    backend: '后端',
+    common: '通用',
+    通用: '通用',
+  };
+  return labels[category] || category;
+}
+
+function buildSkillTablesByCategory(entries) {
+  const groups = groupSkillsByCategory(entries);
+  const order = ['frontend', 'backend', 'common', '通用'];
+  const seen = new Set();
+  const parts = [];
+  for (const cat of order) {
+    if (!groups[cat] || groups[cat].length === 0) continue;
+    if (seen.has(cat)) continue;
+    seen.add(cat);
+    const rows = groups[cat].map(s => `| ${s.name} | ${s.desc} |`).join('\n');
+    parts.push(`### ${categoryLabel(cat)}\n\n| Skill | 触发条件 |\n|-------|---------|\n${rows}`);
+  }
+  for (const cat of Object.keys(groups)) {
+    if (seen.has(cat)) continue;
+    const rows = groups[cat].map(s => `| ${s.name} | ${s.desc} |`).join('\n');
+    parts.push(`### ${categoryLabel(cat)}\n\n| Skill | 触发条件 |\n|-------|---------|\n${rows}`);
+  }
+  return parts.join('\n\n');
+}
+
+const SENTINEL_BEGIN = '<!-- pandax:begin (do not edit between these markers) -->';
+const SENTINEL_END = '<!-- pandax:end -->';
+
+function wrapWithSentinel(body) {
+  return `${SENTINEL_BEGIN}\n${body.replace(/\n+$/, '')}\n${SENTINEL_END}\n`;
+}
+
+function writeOrDelete(filePath, head, tail) {
+  const headTrim = head.replace(/\s+$/, '');
+  const tailTrim = tail.replace(/^\s+/, '');
+  let body = headTrim;
+  if (headTrim && tailTrim) body += '\n\n' + tailTrim;
+  else body += tailTrim;
+  body = body.replace(/\s+$/, '');
+  if (body.length === 0) {
+    removeSync(filePath);
+  } else {
+    writeFileSync(filePath, body + '\n', 'utf8');
+  }
+}
+
+function cleanBootstrapSection(filePath) {
+  if (!existsSync(filePath)) return false;
+  const content = readFileSync(filePath, 'utf8');
+
+  const sBegin = content.indexOf(SENTINEL_BEGIN);
+  if (sBegin !== -1) {
+    const sEnd = content.indexOf(SENTINEL_END, sBegin + SENTINEL_BEGIN.length);
+    if (sEnd !== -1) {
+      writeOrDelete(filePath, content.slice(0, sBegin), content.slice(sEnd + SENTINEL_END.length));
+      return true;
+    }
+  }
+  return false;
+}
+
+function generateTraeBootstrapRule(projectDir, skillEntries) {
+  const rulesDir = resolve(projectDir, '.trae', 'rules');
+  mkdirSync(rulesDir, { recursive: true });
+
+  const skillTables = buildSkillTablesByCategory(skillEntries);
+
+  const rule = `---
+alwaysApply: true
+---
+
+# Pandax 全栈 AI 编程技能魔盒
+
+你已加载 Pandax 技能框架（${skillEntries.length} 个 skills）。
+
+## 核心规则
+
+1. **收到任务时，先检查是否有匹配的 Pandax skill** — 哪怕只有 1% 的可能性也要检查
+2. **遵循 Pandax 工程规范** — 组件、样式、API、模板等按对应 skill 执行
+3. **验证先于完成** — 声称完成前必须运行验证命令
+
+## 可用 Skills
+
+Skills 位于 \`.trae/skills/\` 目录，每个 skill 有独立的 \`SKILL.md\` 文件。
+
+${skillTables}
+
+## 如何使用
+
+当任务匹配某个 skill 的触发条件时，读取对应的 \`.trae/skills/<skill-name>/SKILL.md\` 并严格遵循其流程。
+`;
+
+  const rulePath = resolve(rulesDir, 'pandax.md');
+  writeFileSync(rulePath, rule, 'utf8');
+  console.log(`  ✅ Trae: bootstrap rule -> ${rulePath}`);
+}
+
+function buildSkillListsByCategory(entries) {
+  const groups = groupSkillsByCategory(entries);
+  const order = ['frontend', 'backend', 'common', '通用'];
+  const seen = new Set();
+  const parts = [];
+  for (const cat of order) {
+    if (!groups[cat] || groups[cat].length === 0) continue;
+    if (seen.has(cat)) continue;
+    seen.add(cat);
+    const items = groups[cat].map(s => `- **${s.name}**: ${s.desc}`).join('\n');
+    parts.push(`### ${categoryLabel(cat)}\n\n${items}`);
+  }
+  for (const cat of Object.keys(groups)) {
+    if (seen.has(cat)) continue;
+    const items = groups[cat].map(s => `- **${s.name}**: ${s.desc}`).join('\n');
+    parts.push(`### ${categoryLabel(cat)}\n\n${items}`);
+  }
+  return parts.join('\n\n');
+}
+
+function generateCodeBuddyBootstrap(baseDir, skillEntries) {
+  const skillList = buildSkillListsByCategory(skillEntries);
+
+  const content = `# Pandax 全栈 AI 编程技能魔盒
+
+本项目已安装 Pandax 技能框架（${skillEntries.length} 个 skills）。
+
+## 核心规则
+
+1. **收到任务时，先检查是否有匹配的 Pandax skill** — 哪怕只有 1% 的可能性也要检查
+2. **遵循 Pandax 工程规范** — 组件、样式、API、模板等按对应 skill 执行
+3. **验证先于完成** — 声称完成前必须运行验证命令
+
+## 可用 Skills
+
+Skills 位于 \`.codebuddy/skills/\` 目录，每个 skill 有独立的 \`SKILL.md\` 文件。
+
+${skillList}
+
+## 如何使用
+
+当任务匹配某个 skill 时，读取对应的 \`.codebuddy/skills/<skill-name>/SKILL.md\` 并严格遵循其流程。
+`;
+
+  const mdPath = resolve(baseDir, 'CODEBUDDY.md');
+  if (existsSync(mdPath)) {
+    const existing = readFileSync(mdPath, 'utf8');
+    if (!existing.includes('Pandax 全栈 AI 编程技能魔盒')) {
+      writeFileSync(mdPath, existing.replace(/\s+$/, '') + '\n\n' + wrapWithSentinel(content), 'utf8');
+      console.log(`  ✅ CodeBuddy: 追加 skills 引用 -> ${mdPath}`);
+    } else {
+      console.log(`  ✅ CodeBuddy: CODEBUDDY.md 已包含 Pandax skills 引用`);
+    }
+  } else {
+    writeFileSync(mdPath, wrapWithSentinel(content), 'utf8');
+    console.log(`  ✅ CodeBuddy: bootstrap -> ${mdPath}`);
+  }
+}
+
+// 支持的目标工具
+const TARGETS = [
+  { name: 'Trae', dir: '.trae/skills', detect: '.trae', generateBootstrap: generateTraeBootstrapRule },
+  { name: 'Cursor', dir: '.cursor/skills', detect: ['.cursor', '.cursorrules'] },
+  { name: 'Claude Code', dir: '.claude/skills', detect: '.claude' },
+  { name: 'Codex CLI', dir: '.codex/skills', detect: '.codex' },
+  { name: 'OpenCode', dir: '.opencode/skills', detect: '.opencode' },
+  { name: 'Cline', dir: '.cline/skills', detect: '.clinerules' },
+  { name: 'CodeBuddy', dir: '.codebuddy/skills', detect: ['.codebuddy', 'CODEBUDDY.md'], generateBootstrap: generateCodeBuddyBootstrap },
+];
+
+const TOOL_ALIASES = {
+  trae: 'Trae',
+  cursor: 'Cursor',
+  claude: 'Claude Code',
+  'claude-code': 'Claude Code',
+  claudecode: 'Claude Code',
+  codex: 'Codex CLI',
+  opencode: 'OpenCode',
+  cline: 'Cline',
+  codebuddy: 'CodeBuddy',
+  'codebuddy-code': 'CodeBuddy',
+  codebuddycode: 'CodeBuddy',
+  'codebuddy-cn': 'CodeBuddy',
+};
+
+function installForTarget(target, baseDir, skillEntries) {
+  const dest = resolve(baseDir, target.dir);
+  const srcCount = countDirs(SKILLS_SRC);
+  mkdirSync(dest, { recursive: true });
+  copyDirSync(SKILLS_SRC, dest);
+  const totalAfter = countDirs(dest);
+  if (srcCount > 0 && totalAfter === 0) {
+    throw new Error(
+      `复制 skills 失败：源目录 ${SKILLS_SRC} 有 ${srcCount} 个 skill，但目标 ${dest} 为空。` +
+      `\n  请尝试：npm cache clean --force && npx ${PKG.name}`
+    );
+  }
+  console.log(`  ✅ ${target.name}: ${srcCount} 个 skills -> ${dest}`);
+
+  if (target.generateBootstrap) {
+    target.generateBootstrap(baseDir, skillEntries);
+  }
+}
+
+function isHomeDir(p) {
+  const home = homedir();
+  if (!home) return false;
+  try {
+    return realpathSync(p) === realpathSync(home);
+  } catch { return resolve(p) === resolve(home); }
+}
+
+function listTemplates() {
+  if (!existsSync(TEMPLATES_SRC)) return [];
+  return readdirSync(TEMPLATES_SRC, { withFileTypes: true })
+    .filter(e => e.isDirectory())
+    .map(e => e.name);
+}
+
+function copyTemplateSync(templateName, destDir) {
+  const src = resolve(TEMPLATES_SRC, templateName);
+  if (!existsSync(src)) {
+    throw new Error(`模板不存在: ${templateName}`);
+  }
+  copyDirSync(src, destDir);
+}
+
+function mergeFileIfExists(filePath, content) {
+  if (existsSync(filePath)) {
+    const existing = readFileSync(filePath, 'utf8');
+    if (existing.includes(content.trim())) return false;
+    writeFileSync(filePath, existing.replace(/\s+$/, '') + '\n\n' + content.trim() + '\n', 'utf8');
+    return true;
+  }
+  writeFileSync(filePath, content, 'utf8');
+  return true;
+}
+
+function init(templateName, withSkills) {
+  console.log(`\n  ${PKG.name} v${PKG.version} — 初始化 ${templateName} 模板\n`);
+
+  if (!existsSync(TEMPLATES_SRC)) {
+    console.error('  ❌ 错误：templates 源目录不存在。');
+    process.exit(1);
+  }
+
+  const templates = listTemplates();
+  if (templates.length === 0) {
+    console.error('  ❌ 错误：没有可用的模板。');
+    process.exit(1);
+  }
+
+  if (!templateName) {
+    console.error(`  ❌ --init 需要指定模板名。可用模板: ${templates.join(', ')}\n`);
+    process.exit(1);
+  }
+
+  if (!templates.includes(templateName)) {
+    console.error(`  ❌ 未知模板: ${templateName}`);
+    console.error(`  可用模板: ${templates.join(', ')}\n`);
+    process.exit(1);
+  }
+
+  if (!withSkills && isHomeDir(PROJECT_DIR)) {
+    console.error(
+`  ⚠️  当前目录是用户主目录: ${PROJECT_DIR}
+
+  ${PKG.name} --init 应该执行到具体项目目录。
+  请先 cd 到项目目录后重试：
+    cd /path/to/your/project && npx ${PKG.name} --init ${templateName}
+`);
+    process.exit(1);
+  }
+
+  copyTemplateSync(templateName, PROJECT_DIR);
+  console.log(`  ✅ ${templateName} 模板已初始化到: ${PROJECT_DIR}\n`);
+
+  if (withSkills) {
+    console.log(`  继续安装 skills...\n`);
+    install(undefined, true);
+  } else {
+    console.log('  提示：如需同时安装 skills，可执行:\n');
+    console.log(`    npx ${PKG.name} --init ${templateName} --with-skills\n`);
+  }
+}
+
+function showHelp() {
+  console.log(`
+  ${PKG.name} v${PKG.version} — Pandax 全栈 AI 编程技能魔盒
+
+  用法：
+    npx ${PKG.name}                              项目级：自动检测工具并安装 skills
+    npx ${PKG.name} --tool trae                  指定工具安装 skills
+    npx ${PKG.name} --init vue3                  初始化 Vue3 项目模板
+    npx ${PKG.name} --init vue3 --with-skills    初始化 Vue3 模板并安装 skills
+    npx ${PKG.name} --uninstall                  卸载当前项目 skills
+    npx ${PKG.name} --help                       显示帮助
+    npx ${PKG.name} --version                    显示版本
+
+  支持的工具名：
+    ${Object.keys(TOOL_ALIASES).join(', ')}
+
+  可用模板：
+    ${listTemplates().join(', ') || '(无)'}
+
+  说明：
+    项目级：把 ${countDirs(SKILLS_SRC)} 个 skills 装到当前项目对应目录（如 .trae/skills）。
+`);
+}
+
+function uninstall() {
+  const baseDir = PROJECT_DIR;
+  console.log(`\n  ${PKG.name} v${PKG.version} — 卸载（项目级）\n`);
+  console.log(`  目标: ${baseDir}\n`);
+
+  if (!existsSync(SKILLS_SRC)) {
+    console.error('  ❌ 错误：skills 源目录不存在，无法识别要卸载的 skill 名单。');
+    process.exit(1);
+  }
+
+  const srcSkillNames = new Set(
+    readdirSync(SKILLS_SRC, { withFileTypes: true })
+      .filter(e => e.isDirectory())
+      .map(e => e.name)
+  );
+
+  let totalSkills = 0;
+  for (const target of TARGETS) {
+    const dest = resolve(baseDir, target.dir);
+    if (!existsSync(dest)) continue;
+    let removed = 0;
+    for (const entry of readdirSync(dest, { withFileTypes: true })) {
+      if (entry.isDirectory() && srcSkillNames.has(entry.name)) {
+        removeSync(resolve(dest, entry.name), { recursive: true, force: true });
+        removed++;
+      }
+    }
+    if (removed > 0) {
+      console.log(`  ✅ ${target.name}: 移除 ${removed} 个 skills <- ${dest}`);
+      totalSkills += removed;
+    }
+    try {
+      if (existsSync(dest)) {
+        const left = readdirSync(dest).filter(n => n !== '.DS_Store');
+        if (left.length === 0) removeSync(dest, { recursive: true, force: true });
+      }
+    } catch {}
+  }
+
+  // 删除 Trae bootstrap rule
+  const rulePath = resolve(baseDir, '.trae', 'rules', 'pandax.md');
+  let bootstrapsRemoved = 0;
+  if (existsSync(rulePath)) {
+    removeSync(rulePath);
+    console.log(`  ✅ 删除 bootstrap: ${rulePath}`);
+    bootstrapsRemoved++;
+  }
+
+  // 清理 CodeBuddy CODEBUDDY.md 中的 sentinel 段落
+  const codeBuddyPath = resolve(baseDir, 'CODEBUDDY.md');
+  if (cleanBootstrapSection(codeBuddyPath)) {
+    console.log(`  ✅ 清理 bootstrap: ${codeBuddyPath}`);
+    bootstrapsRemoved++;
+  }
+
+  if (totalSkills === 0 && bootstrapsRemoved === 0) {
+    console.log(`  ⚠️  未在当前目录找到 ${PKG.name} 安装痕迹。`);
+  } else {
+    console.log(`\n  卸载完成。共移除 ${totalSkills} 个 skill 目录、${bootstrapsRemoved} 个 bootstrap 文件。\n`);
+  }
+}
+
+function install(forceToolName, force) {
+  try {
+    console.log(`\n  ${PKG.name} v${PKG.version} — Pandax 全栈 AI 编程技能魔盒\n`);
+
+    if (!existsSync(SKILLS_SRC)) {
+      console.error('  ❌ 错误：skills 源目录不存在。');
+      process.exit(1);
+    }
+
+    if (!force && isHomeDir(PROJECT_DIR)) {
+      console.error(
+`  ⚠️  当前目录是用户主目录: ${PROJECT_DIR}
+
+  ${PKG.name} 应该装到具体项目目录，而不是 ~/。
+  请先 cd 到项目目录后重试：
+    cd /path/to/your/project && npx ${PKG.name}
+
+  如果你确实要在主目录安装（不推荐），加 --force：
+    npx ${PKG.name} --force
+`);
+      process.exit(1);
+    }
+
+    const skillEntries = scanSkillEntries(SKILLS_SRC);
+
+    console.log(`  源: ${skillEntries.length} 个 skills`);
+    console.log(`  模式: 项目级`);
+    console.log(`  目标: ${PROJECT_DIR}\n`);
+
+    if (forceToolName) {
+      const target = TARGETS.find(t => t.name === forceToolName);
+      if (!target) {
+        console.error(`  ❌ 未知工具: ${forceToolName}`);
+        process.exit(1);
+      }
+      installForTarget(target, PROJECT_DIR, skillEntries);
+      console.log('\n  安装完成！重启你的 AI 编程工具即可生效。\n');
+      return;
+    }
+
+    let installed = 0;
+    for (const target of TARGETS) {
+      const detectMarker = target.detect;
+      const detects = Array.isArray(detectMarker) ? detectMarker : [detectMarker];
+      const found = detects.some(d => existsSync(resolve(PROJECT_DIR, d)));
+      if (found) {
+        installForTarget(target, PROJECT_DIR, skillEntries);
+        installed++;
+      }
+    }
+
+    if (installed === 0) {
+      console.log(`  ⚠️  未在当前目录检测到任何已知 AI 编程工具的标记。\n`);
+      console.log('  为避免装错工具，未做任何安装。请用 --tool 显式指定你的工具，例如：\n');
+      console.log(`    npx ${PKG.name} --tool trae          # Trae`);
+      console.log(`    npx ${PKG.name} --tool cursor        # Cursor`);
+      console.log(`    npx ${PKG.name} --tool claude        # Claude Code\n`);
+      process.exit(1);
+    }
+
+    console.log('\n  安装完成！重启你的 AI 编程工具即可生效。\n');
+  } catch (err) {
+    console.error(`  ❌ 安装失败：${err.message}`);
+    process.exit(1);
+  }
+}
+
+const args = process.argv.slice(2);
+const helpIdx = args.findIndex(a => a === '--help' || a === '-h');
+const versionIdx = args.findIndex(a => a === '--version' || a === '-v');
+const toolIdx = args.findIndex(a => a === '--tool' || a === '-t');
+const initIdx = args.findIndex(a => a === '--init' || a === '-i');
+const uninstallIdx = args.findIndex(a => a === '--uninstall' || a === '-u');
+const forceIdx = args.findIndex(a => a === '--force' || a === '-f');
+const withSkillsIdx = args.findIndex(a => a === '--with-skills');
+const force = forceIdx !== -1;
+const withSkills = withSkillsIdx !== -1;
+
+const KNOWN_FLAGS = new Set([
+  '--help', '-h', '--version', '-v', '--uninstall', '-u', '--force', '-f',
+  '--tool', '-t', '--init', '-i', '--with-skills'
+]);
+
+if (helpIdx !== -1) {
+  showHelp();
+} else if (versionIdx !== -1) {
+  console.log(PKG.version);
+} else if (uninstallIdx !== -1) {
+  uninstall();
+} else if (initIdx !== -1) {
+  const templateArg = args[initIdx + 1];
+  init(templateArg, withSkills);
+} else if (toolIdx !== -1) {
+  const toolArg = args[toolIdx + 1];
+  if (!toolArg) {
+    console.error('  ❌ --tool 需要指定工具名，例如: --tool trae\n');
+    showHelp();
+    process.exit(1);
+  }
+  const toolName = TOOL_ALIASES[toolArg.toLowerCase()];
+  if (!toolName) {
+    console.error(`  ❌ 未知工具: ${toolArg}`);
+    console.error(`  支持的工具: ${Object.keys(TOOL_ALIASES).join(', ')}\n`);
+    process.exit(1);
+  }
+  install(toolName, force);
+} else {
+  const unknown = args.find(a => a.startsWith('-') && !KNOWN_FLAGS.has(a));
+  if (unknown) {
+    console.warn(`  未知参数: ${unknown}\n`);
+    showHelp();
+    process.exit(1);
+  }
+  install(undefined, force);
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "pandax",
+  "version": "0.0.1",
+  "description": "Pandax 全栈 AI 编程技能魔盒，支持通过 npx 安装 skills 到 Trae/Cursor/CodeBuddy 等工具",
+  "bin": {
+    "pandax": "bin/pandax.js"
+  },
+  "scripts": {
+    "test": "node bin/pandax.js --help"
+  },
+  "keywords": [
+    "pandax",
+    "pandora",
+    "skills",
+    "ai-coding",
+    "trae",
+    "cursor",
+    "codebuddy",
+    "superpowers",
+    "frontend",
+    "backend"
+  ],
+  "files": [
+    "bin/",
+    "skills/",
+    "templates/"
+  ],
+  "author": "Pandax Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}