team-skills 1.3.3 → 1.3.4

package/CHANGELOG.md

@@ -7,6 +7,13 @@
 
 ## [Unreleased]
 
+## [1.3.4] - 2026-06-26
+
+### 变更
+
+- 全局安装目录从 2 个扩展为 3 个：新增 `~/.cursor/skills/`（Cursor 全局 Skills 目录）
+- `setup`、`update`、`uninstall`、`list` 四个命令统一使用循环模式处理 3 个全局目标（Agents / Cursor / Claude Code）
+
 ## [1.3.3] - 2026-06-26
 
 ### 变更

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "team-skills",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "AI Agent Skills framework — Spec-Driven development with directed-graph rollback and quality gates",
   "type": "module",
   "bin": {

package/src/commands/init.js

@@ -1,9 +1,8 @@
-import { join, resolve } from 'node:path';
-import { copyFileSync as fsCopyFile, existsSync, rmSync } from 'node:fs';
+import { resolve } from 'node:path';
 import { PACKAGE_ROOT } from '../lib/constants.js';
 import { discoverSkills, discoverSharedRules } from '../lib/inventory.js';
-import { copyRecursive, ensureDir } from '../lib/fs-utils.js';
 import { detectIDE } from '../lib/detect-ide.js';
+import { installSkillsProject } from '../lib/installers.js';
 import * as log from '../lib/logger.js';
 
 export function registerInit(program) {
@@ -23,65 +22,13 @@ function runInit(dir, opts) {
   const exclude = withScore ? [] : ['team-score'];
   const ides = detectIDE(dir, ide, { strict: true });
 
-  const tag = dryRun ? '[dry-run] ' : '';
-  let count = 0;
-
   log.heading('初始化 team-skills 到项目');
   log.info(`项目目录: ${dir}`);
   log.info(`目标 IDE: ${ides.join(', ')}`);
 
   const skills = discoverSkills(PACKAGE_ROOT, { exclude });
   const rules = discoverSharedRules();
-
-  // Cursor: skills → .cursor/skills/
-  if (ides.includes('cursor')) {
-    const skillsDst = join(dir, '.cursor', 'skills');
-    log.heading(`复制 Skills → ${skillsDst}`);
-
-    if (!dryRun) ensureDir(skillsDst);
-    for (const skill of skills) {
-      const dest = join(skillsDst, skill.name);
-      if (!dryRun) {
-        if (existsSync(dest)) rmSync(dest, { recursive: true });
-        copyRecursive(skill.path, dest);
-      }
-      log.success(`${tag}Skill: ${skill.name}`);
-      count++;
-    }
-
-    const rulesDst = join(skillsDst, '_team-rules');
-    if (!dryRun) ensureDir(rulesDst);
-    for (const r of rules) {
-      if (!dryRun) fsCopyFile(r.path, join(rulesDst, r.name));
-      log.success(`${tag}Rule: ${r.name}`);
-      count++;
-    }
-  }
-
-  // Claude Code: skills → .claude/skills/ (same structure as Cursor)
-  if (ides.includes('claude')) {
-    const skillsDst = join(dir, '.claude', 'skills');
-    log.heading(`复制 Skills → ${skillsDst}`);
-
-    if (!dryRun) ensureDir(skillsDst);
-    for (const skill of skills) {
-      const dest = join(skillsDst, skill.name);
-      if (!dryRun) {
-        if (existsSync(dest)) rmSync(dest, { recursive: true });
-        copyRecursive(skill.path, dest);
-      }
-      log.success(`${tag}Skill: ${skill.name}`);
-      count++;
-    }
-
-    const rulesDst = join(skillsDst, '_team-rules');
-    if (!dryRun) ensureDir(rulesDst);
-    for (const r of rules) {
-      if (!dryRun) fsCopyFile(r.path, join(rulesDst, r.name));
-      log.success(`${tag}Rule: ${r.name}`);
-      count++;
-    }
-  }
+  const count = installSkillsProject(dir, ides, skills, rules, { dryRun });
 
   log.done(`初始化完成${dryRun ? ' (dry-run)' : ''}！共 ${count} 个组件。`);
 }

package/src/commands/list.js

@@ -1,9 +1,6 @@
 import { join } from 'node:path';
 import { existsSync, readlinkSync } from 'node:fs';
-import {
-  DEFAULT_SKILLS_TARGET,
-  DEFAULT_CLAUDE_SKILLS_TARGET,
-} from '../lib/constants.js';
+import { DEFAULT_SKILLS_TARGET, resolveTargets } from '../lib/constants.js';
 import { discoverSkills, discoverSharedRules } from '../lib/inventory.js';
 import { isSymlink } from '../lib/fs-utils.js';
 import * as log from '../lib/logger.js';
@@ -19,48 +16,29 @@ export function registerList(program) {
 
 function runList(opts) {
   const { target, json } = opts;
-  const results = { skills: [], rules: [], skillCommands: [] };
+  const results = { skills: [], rules: [] };
 
-  // Check symlink-based install
   const skills = discoverSkills();
-  for (const skill of skills) {
-    const dest = join(target, skill.name);
-    results.skills.push({
-      name: skill.name,
-      status: getStatus(dest, skill.path),
-      path: dest,
-    });
-  }
-
-  // Shared rules
-  for (const rule of discoverSharedRules()) {
-    const dest = join(target, '_team-rules', rule.name);
-    results.rules.push({
-      name: rule.name,
-      status: getStatus(dest, rule.path),
-      path: dest,
-    });
-  }
-
-  // Claude Code Skills
-  const claudeSkillsTarget = DEFAULT_CLAUDE_SKILLS_TARGET;
-  for (const skill of skills) {
-    const dest = join(claudeSkillsTarget, skill.name);
-    results.skillCommands.push({
-      name: skill.name,
-      status: getStatus(dest, skill.path),
-      path: dest,
-    });
-  }
+  const rules = discoverSharedRules();
+  const targets = resolveTargets(target);
 
-  // Claude Code shared rules
-  for (const rule of discoverSharedRules()) {
-    const claudeRuleDest = join(claudeSkillsTarget, '_team-rules', rule.name);
-    results.rules.push({
-      name: `Claude/${rule.name}`,
-      status: getStatus(claudeRuleDest, rule.path),
-      path: claudeRuleDest,
-    });
+  for (const t of targets) {
+    for (const skill of skills) {
+      const dest = join(t.dir, skill.name);
+      results.skills.push({
+        name: `${t.label}/${skill.name}`,
+        status: getStatus(dest, skill.path),
+        path: dest,
+      });
+    }
+    for (const rule of rules) {
+      const dest = join(t.dir, '_team-rules', rule.name);
+      results.rules.push({
+        name: `${t.label}/${rule.name}`,
+        status: getStatus(dest, rule.path),
+        path: dest,
+      });
+    }
   }
 
   if (json) {
@@ -68,17 +46,14 @@ function runList(opts) {
     return;
   }
 
-  // Pretty print
-  log.heading('Agent Skills');
-  printTable(results.skills);
+  for (const t of targets) {
+    log.heading(`${t.label} Skills`);
+    printTable(results.skills.filter(s => s.name.startsWith(`${t.label}/`)));
+  }
 
   log.heading('共享规则');
   printTable(results.rules);
 
-  log.heading('Claude Code Skills');
-  printTable(results.skillCommands);
-
-  // Summary
   const installed = results.skills.filter(s => s.status === 'ok' || s.status === 'file').length;
   const total = results.skills.length;
   console.log(`\nSkills: ${installed}/${total} 已安装`);

package/src/commands/setup.js

@@ -1,9 +1,6 @@
-import { join } from 'node:path';
-import {
-  PACKAGE_ROOT, DEFAULT_SKILLS_TARGET, DEFAULT_CLAUDE_SKILLS_TARGET,
-} from '../lib/constants.js';
+import { PACKAGE_ROOT, DEFAULT_SKILLS_TARGET, resolveTargets } from '../lib/constants.js';
 import { discoverSkills, discoverSharedRules } from '../lib/inventory.js';
-import { createSymlinkSafe, ensureDir, isSymlink } from '../lib/fs-utils.js';
+import { installSkillsGlobal, verifyGlobalSymlinks } from '../lib/installers.js';
 import * as log from '../lib/logger.js';
 
 export function registerSetup(program) {
@@ -17,72 +14,14 @@ export function registerSetup(program) {
 
 function runSetup(target, opts) {
   const { dryRun } = opts;
-  const tag = dryRun ? '[dry-run] ' : '';
-  let count = 0;
-
-  // Skills → ~/.agents/skills/ (Cursor auto-discovers from here)
-  log.heading('安装 Skills → Cursor');
   const skills = discoverSkills(PACKAGE_ROOT);
-  for (const skill of skills) {
-    const dest = join(target, skill.name);
-    const result = createSymlinkSafe(skill.path, dest, { force: true, dryRun });
-    logResult(`${tag}Skill: ${skill.name}`, result);
-    if (result === 'created' || result === 'dry-run') count++;
-  }
-
-  // Shared rules → ~/.agents/skills/_team-rules/
-  log.heading('安装共享规则');
   const rules = discoverSharedRules();
-  const rulesTarget = join(target, '_team-rules');
-  if (!dryRun) ensureDir(rulesTarget);
-  for (const rule of rules) {
-    const dest = join(rulesTarget, rule.name);
-    const result = createSymlinkSafe(rule.path, dest, { force: true, dryRun });
-    logResult(`${tag}Rule: ${rule.name}`, result);
-    if (result === 'created' || result === 'dry-run') count++;
-  }
-
-  // Skills → ~/.claude/skills/ (Claude Code auto-discovers from here)
-  log.heading('安装 Skills → Claude Code');
-  const claudeSkillsTarget = DEFAULT_CLAUDE_SKILLS_TARGET;
-  if (!dryRun) ensureDir(claudeSkillsTarget);
-  for (const skill of skills) {
-    const dest = join(claudeSkillsTarget, skill.name);
-    const result = createSymlinkSafe(skill.path, dest, { force: true, dryRun });
-    logResult(`${tag}Skill: ${skill.name}`, result);
-    if (result === 'created' || result === 'dry-run') count++;
-  }
+  const targets = resolveTargets(target);
 
-  // Shared rules → ~/.claude/skills/_team-rules/
-  log.heading('安装 Claude Code 共享规则');
-  const claudeRulesTarget = join(claudeSkillsTarget, '_team-rules');
-  if (!dryRun) ensureDir(claudeRulesTarget);
-  for (const rule of rules) {
-    const dest = join(claudeRulesTarget, rule.name);
-    const result = createSymlinkSafe(rule.path, dest, { force: true, dryRun });
-    logResult(`${tag}Rule: ${rule.name}`, result);
-    if (result === 'created' || result === 'dry-run') count++;
-  }
+  const count = installSkillsGlobal(targets, skills, rules, { dryRun });
 
   if (!dryRun) {
-    log.heading('验证安装');
-    let errors = 0;
-    const verify = (label, dest) => {
-      if (isSymlink(dest)) {
-        log.success(label);
-      } else {
-        log.error(`${label} 未正确安装`);
-        errors++;
-      }
-    };
-    for (const skill of skills) {
-      verify(`Cursor Skill: ${skill.name}`, join(target, skill.name));
-      verify(`Claude Skill: ${skill.name}`, join(claudeSkillsTarget, skill.name));
-    }
-    for (const rule of rules) {
-      verify(`Rule: ${rule.name}`, join(rulesTarget, rule.name));
-      verify(`Claude Rule: ${rule.name}`, join(claudeRulesTarget, rule.name));
-    }
+    const errors = verifyGlobalSymlinks(targets, skills, rules);
     if (errors > 0) {
       log.error(`有 ${errors} 个组件安装异常，请检查。`);
       process.exit(1);
@@ -94,17 +33,3 @@ function runSetup(target, opts) {
     console.log('\n后续可通过 team-skills setup 重新安装，或 team-skills uninstall 卸载。');
   }
 }
-
-function logResult(label, result) {
-  switch (result) {
-    case 'created':
-    case 'dry-run':
-      log.success(label);
-      break;
-    case 'exists':
-      log.skip(`${label}（已存在，跳过）`);
-      break;
-    default:
-      log.info(label);
-  }
-}

package/src/commands/uninstall.js

@@ -1,8 +1,5 @@
 import { join } from 'node:path';
-import {
-  PACKAGE_ROOT, DEFAULT_SKILLS_TARGET,
-  DEFAULT_CLAUDE_SKILLS_TARGET,
-} from '../lib/constants.js';
+import { DEFAULT_SKILLS_TARGET, resolveTargets } from '../lib/constants.js';
 import { discoverSkills, discoverSharedRules } from '../lib/inventory.js';
 import { removeSymlinkSafe, rmdirIfEmpty } from '../lib/fs-utils.js';
 import * as log from '../lib/logger.js';
@@ -35,34 +32,23 @@ function runUninstall(target, opts) {
   const { dryRun } = opts;
   let removed = 0;
 
-  // Cursor Skills → ~/.agents/skills/
-  log.heading('移除 Cursor Skills');
   const skills = discoverSkills();
-  for (const skill of skills) {
-    if (remove(join(target, skill.name), skill.path, `Skill: ${skill.name}`, dryRun)) removed++;
+  const rules = discoverSharedRules();
+  const targets = resolveTargets(target);
+
+  for (const t of targets) {
+    log.heading(`移除 ${t.label} Skills`);
+    for (const skill of skills) {
+      if (remove(join(t.dir, skill.name), skill.path, `${t.label} Skill: ${skill.name}`, dryRun)) removed++;
+    }
+
+    log.heading(`移除 ${t.label} 共享规则`);
+    for (const rule of rules) {
+      if (remove(join(t.dir, '_team-rules', rule.name), rule.path, `${t.label} Rule: ${rule.name}`, dryRun)) removed++;
+    }
+    if (!dryRun) rmdirIfEmpty(join(t.dir, '_team-rules'));
   }
 
-  // Claude Code Skills → ~/.claude/skills/
-  log.heading('移除 Claude Code Skills');
-  const claudeSkillsTarget = DEFAULT_CLAUDE_SKILLS_TARGET;
-  for (const skill of skills) {
-    if (remove(join(claudeSkillsTarget, skill.name), skill.path, `Claude Skill: ${skill.name}`, dryRun)) removed++;
-  }
-
-  // Claude Code shared rules → ~/.claude/skills/_team-rules/
-  log.heading('移除 Claude Code 共享规则');
-  for (const rule of discoverSharedRules()) {
-    if (remove(join(claudeSkillsTarget, '_team-rules', rule.name), rule.path, `Claude Rule: ${rule.name}`, dryRun)) removed++;
-  }
-  if (!dryRun) rmdirIfEmpty(join(claudeSkillsTarget, '_team-rules'));
-
-  // Shared rules
-  log.heading('移除共享规则');
-  for (const rule of discoverSharedRules()) {
-    if (remove(join(target, '_team-rules', rule.name), rule.path, `Rule: ${rule.name}`, dryRun)) removed++;
-  }
-  if (!dryRun) rmdirIfEmpty(join(target, '_team-rules'));
-
   log.done(`卸载完成${dryRun ? ' (dry-run)' : ''}，共移除 ${removed} 个软链接。`);
   if (!dryRun) console.log('本仓库源文件未受影响。');
 }

package/src/commands/update.js

@@ -1,12 +1,13 @@
 import { join, resolve } from 'node:path';
-import { existsSync, copyFileSync as fsCopyFile, rmSync, readdirSync, readFileSync } from 'node:fs';
+import { readFileSync } from 'node:fs';
 import { execSync } from 'node:child_process';
-import {
-  PACKAGE_ROOT, DEFAULT_SKILLS_TARGET, DEFAULT_CLAUDE_SKILLS_TARGET,
-} from '../lib/constants.js';
+import { PACKAGE_ROOT, GLOBAL_TARGETS, PROJECT_IDE_DIRS } from '../lib/constants.js';
 import { discoverSkills, discoverSharedRules } from '../lib/inventory.js';
-import { copyRecursive, ensureDir, createSymlinkSafe, isSymlink } from '../lib/fs-utils.js';
 import { detectIDE } from '../lib/detect-ide.js';
+import {
+  installSkillsGlobal, verifyGlobalSymlinks,
+  installSkillsProject, cleanStaleSkills,
+} from '../lib/installers.js';
 import * as log from '../lib/logger.js';
 
 export function registerUpdate(program) {
@@ -47,111 +48,37 @@ function upgradeSelf(dryRun) {
   }
 }
 
-function cleanStaleSkills(targetDir, currentNames, dryRun, exclude = []) {
-  if (!existsSync(targetDir)) return;
-  const existing = readdirSync(targetDir).filter(
-    name => !name.startsWith('_') && name !== 'CLAUDE.md' && name.startsWith('team-'),
-  );
-  for (const name of existing) {
-    if (!currentNames.has(name) && !exclude.includes(name)) {
-      const tag = dryRun ? '[dry-run] ' : '';
-      if (!dryRun) rmSync(join(targetDir, name), { recursive: true });
-      log.warn(`${tag}移除旧 Skill: ${name}`);
-    }
-  }
-}
-
 function runUpdate(dir, opts) {
   dir = resolve(dir);
   const { ide, withScore, skipSelf, dryRun } = opts;
 
   if (!skipSelf) upgradeSelf(dryRun);
 
-  const exclude = withScore ? [] : ['team-score'];
-  const tag = dryRun ? '[dry-run] ' : '';
-  let count = 0;
-
-  // ── Global: always include team-score ──
   const allSkills = discoverSkills(PACKAGE_ROOT);
   const rules = discoverSharedRules();
   const allSkillNames = new Set(allSkills.map(s => s.name));
 
   log.heading('更新全局 Skills');
-
-  // Cursor global: ~/.agents/skills/
-  const cursorGlobal = DEFAULT_SKILLS_TARGET;
-  log.heading(`更新 Skills → ${cursorGlobal}`);
-  cleanStaleSkills(cursorGlobal, allSkillNames, dryRun);
-  if (!dryRun) ensureDir(cursorGlobal);
-  for (const skill of allSkills) {
-    const dest = join(cursorGlobal, skill.name);
-    const result = createSymlinkSafe(skill.path, dest, { force: true, dryRun });
-    logGlobalResult(`${tag}Skill: ${skill.name}`, result);
-    if (result === 'created' || result === 'dry-run') count++;
-  }
-  const cursorRulesDst = join(cursorGlobal, '_team-rules');
-  if (!dryRun) ensureDir(cursorRulesDst);
-  for (const r of rules) {
-    const dest = join(cursorRulesDst, r.name);
-    const result = createSymlinkSafe(r.path, dest, { force: true, dryRun });
-    logGlobalResult(`${tag}Rule: ${r.name}`, result);
-    if (result === 'created' || result === 'dry-run') count++;
-  }
-
-  // Claude Code global: ~/.claude/skills/
-  const claudeGlobal = DEFAULT_CLAUDE_SKILLS_TARGET;
-  log.heading(`更新 Skills → ${claudeGlobal}`);
-  cleanStaleSkills(claudeGlobal, allSkillNames, dryRun);
-  if (!dryRun) ensureDir(claudeGlobal);
-  for (const skill of allSkills) {
-    const dest = join(claudeGlobal, skill.name);
-    const result = createSymlinkSafe(skill.path, dest, { force: true, dryRun });
-    logGlobalResult(`${tag}Skill: ${skill.name}`, result);
-    if (result === 'created' || result === 'dry-run') count++;
-  }
-  const claudeRulesDst = join(claudeGlobal, '_team-rules');
-  if (!dryRun) ensureDir(claudeRulesDst);
-  for (const r of rules) {
-    const dest = join(claudeRulesDst, r.name);
-    const result = createSymlinkSafe(r.path, dest, { force: true, dryRun });
-    logGlobalResult(`${tag}Rule: ${r.name}`, result);
-    if (result === 'created' || result === 'dry-run') count++;
+  for (const t of GLOBAL_TARGETS) {
+    cleanStaleSkills(t.dir, allSkillNames, { dryRun });
   }
+  let count = installSkillsGlobal(GLOBAL_TARGETS, allSkills, rules, { dryRun, verb: '更新' });
 
-  // Verify global symlinks
   if (!dryRun) {
-    log.heading('验证全局安装');
-    let errors = 0;
-    const verify = (label, dest) => {
-      if (isSymlink(dest)) {
-        log.success(label);
-      } else {
-        log.error(`${label} 未正确安装`);
-        errors++;
-      }
-    };
-    for (const skill of allSkills) {
-      verify(`Cursor Skill: ${skill.name}`, join(cursorGlobal, skill.name));
-      verify(`Claude Skill: ${skill.name}`, join(claudeGlobal, skill.name));
-    }
-    for (const r of rules) {
-      verify(`Rule: ${r.name}`, join(cursorRulesDst, r.name));
-      verify(`Claude Rule: ${r.name}`, join(claudeRulesDst, r.name));
-    }
+    const errors = verifyGlobalSymlinks(GLOBAL_TARGETS, allSkills, rules);
     if (errors > 0) {
       log.error(`有 ${errors} 个全局组件安装异常，请检查。`);
     }
   }
 
-  // ── Project: respect --with-score ──
   const ides = detectIDE(dir, ide);
-
   if (ides.length === 0) {
     log.info('当前项目未检测到 IDE 配置（.claude/ 或 .cursor/），跳过项目更新。');
     log.done(`更新完成${dryRun ? ' (dry-run)' : ''}！共 ${count} 个组件。`);
     return;
   }
 
+  const exclude = withScore ? [] : ['team-score'];
   const projectSkills = discoverSkills(PACKAGE_ROOT, { exclude });
   const projectSkillNames = new Set(projectSkills.map(s => s.name));
 
@@ -159,71 +86,12 @@ function runUpdate(dir, opts) {
   log.info(`项目目录: ${dir}`);
   log.info(`目标 IDE: ${ides.join(', ')}`);
 
-  if (ides.includes('cursor')) {
-    const skillsDst = join(dir, '.cursor', 'skills');
-    log.heading(`更新 Skills → ${skillsDst}`);
-
-    cleanStaleSkills(skillsDst, projectSkillNames, dryRun, exclude);
-
-    if (!dryRun) ensureDir(skillsDst);
-    for (const skill of projectSkills) {
-      const dest = join(skillsDst, skill.name);
-      if (!dryRun) {
-        if (existsSync(dest)) rmSync(dest, { recursive: true });
-        copyRecursive(skill.path, dest);
-      }
-      log.success(`${tag}Skill: ${skill.name}`);
-      count++;
-    }
-
-    const rulesDst = join(skillsDst, '_team-rules');
-    if (!dryRun) ensureDir(rulesDst);
-    for (const r of rules) {
-      if (!dryRun) fsCopyFile(r.path, join(rulesDst, r.name));
-      log.success(`${tag}Rule: ${r.name}`);
-      count++;
-    }
+  for (const ideName of ides) {
+    const skillsDst = join(dir, PROJECT_IDE_DIRS[ideName], 'skills');
+    cleanStaleSkills(skillsDst, projectSkillNames, { dryRun, exclude });
   }
 
-  if (ides.includes('claude')) {
-    const skillsDst = join(dir, '.claude', 'skills');
-    log.heading(`更新 Skills → ${skillsDst}`);
-
-    cleanStaleSkills(skillsDst, projectSkillNames, dryRun, exclude);
-
-    if (!dryRun) ensureDir(skillsDst);
-    for (const skill of projectSkills) {
-      const dest = join(skillsDst, skill.name);
-      if (!dryRun) {
-        if (existsSync(dest)) rmSync(dest, { recursive: true });
-        copyRecursive(skill.path, dest);
-      }
-      log.success(`${tag}Skill: ${skill.name}`);
-      count++;
-    }
-
-    const rulesDst = join(skillsDst, '_team-rules');
-    if (!dryRun) ensureDir(rulesDst);
-    for (const r of rules) {
-      if (!dryRun) fsCopyFile(r.path, join(rulesDst, r.name));
-      log.success(`${tag}Rule: ${r.name}`);
-      count++;
-    }
-  }
+  count += installSkillsProject(dir, ides, projectSkills, rules, { dryRun, verb: '更新' });
 
   log.done(`更新完成${dryRun ? ' (dry-run)' : ''}！共 ${count} 个组件。`);
 }
-
-function logGlobalResult(label, result) {
-  switch (result) {
-    case 'created':
-    case 'dry-run':
-      log.success(label);
-      break;
-    case 'exists':
-      log.skip(`${label}（已存在，跳过）`);
-      break;
-    default:
-      log.info(label);
-  }
-}

package/src/lib/constants.js

@@ -7,5 +7,19 @@ const __dirname = dirname(__filename);
 
 export const PACKAGE_ROOT = join(__dirname, '..', '..');
 export const DEFAULT_SKILLS_TARGET = join(homedir(), '.agents', 'skills');
+export const DEFAULT_CURSOR_SKILLS_TARGET = join(homedir(), '.cursor', 'skills');
 export const DEFAULT_CLAUDE_SKILLS_TARGET = join(homedir(), '.claude', 'skills');
 export const SKILLS_DIR = 'skills';
+
+export const GLOBAL_TARGETS = [
+  { label: 'Agents', dir: DEFAULT_SKILLS_TARGET },
+  { label: 'Cursor', dir: DEFAULT_CURSOR_SKILLS_TARGET },
+  { label: 'Claude Code', dir: DEFAULT_CLAUDE_SKILLS_TARGET },
+];
+
+export const PROJECT_IDE_DIRS = { cursor: '.cursor', claude: '.claude' };
+
+export function resolveTargets(customFirst) {
+  if (!customFirst || customFirst === DEFAULT_SKILLS_TARGET) return GLOBAL_TARGETS;
+  return GLOBAL_TARGETS.map((t, i) => (i === 0 ? { ...t, dir: customFirst } : t));
+}

package/src/lib/installers.js

@@ -0,0 +1,120 @@
+import { join } from 'node:path';
+import { existsSync, readdirSync, rmSync, copyFileSync } from 'node:fs';
+import { createSymlinkSafe, ensureDir, isSymlink, copyRecursive } from './fs-utils.js';
+import { PROJECT_IDE_DIRS } from './constants.js';
+import * as log from './logger.js';
+
+export function logInstallResult(label, result) {
+  switch (result) {
+    case 'created':
+    case 'dry-run':
+      log.success(label);
+      break;
+    case 'exists':
+      log.skip(`${label}（已存在，跳过）`);
+      break;
+    default:
+      log.info(label);
+  }
+}
+
+export function installSkillsGlobal(targets, skills, rules, { dryRun, verb = '安装' }) {
+  const tag = dryRun ? '[dry-run] ' : '';
+  let count = 0;
+
+  for (const t of targets) {
+    log.heading(`${verb} → ${t.label}`);
+    if (!dryRun) ensureDir(t.dir);
+
+    for (const skill of skills) {
+      const dest = join(t.dir, skill.name);
+      const result = createSymlinkSafe(skill.path, dest, { force: true, dryRun });
+      logInstallResult(`${tag}Skill: ${skill.name}`, result);
+      if (result === 'created' || result === 'dry-run') count++;
+    }
+
+    const rulesDir = join(t.dir, '_team-rules');
+    if (!dryRun) ensureDir(rulesDir);
+    for (const rule of rules) {
+      const dest = join(rulesDir, rule.name);
+      const result = createSymlinkSafe(rule.path, dest, { force: true, dryRun });
+      logInstallResult(`${tag}Rule: ${rule.name}`, result);
+      if (result === 'created' || result === 'dry-run') count++;
+    }
+  }
+
+  return count;
+}
+
+export function verifyGlobalSymlinks(targets, skills, rules) {
+  log.heading('验证安装');
+  let errors = 0;
+
+  const verify = (label, dest) => {
+    if (isSymlink(dest)) {
+      log.success(label);
+    } else {
+      log.error(`${label} 未正确安装`);
+      errors++;
+    }
+  };
+
+  for (const t of targets) {
+    for (const skill of skills) {
+      verify(`${t.label} Skill: ${skill.name}`, join(t.dir, skill.name));
+    }
+    for (const rule of rules) {
+      verify(`${t.label} Rule: ${rule.name}`, join(t.dir, '_team-rules', rule.name));
+    }
+  }
+
+  return errors;
+}
+
+export function installSkillsProject(projectDir, ides, skills, rules, { dryRun, verb = '复制' }) {
+  const tag = dryRun ? '[dry-run] ' : '';
+  let count = 0;
+
+  for (const ideName of ides) {
+    const ideSubdir = PROJECT_IDE_DIRS[ideName];
+    if (!ideSubdir) continue;
+
+    const skillsDst = join(projectDir, ideSubdir, 'skills');
+    log.heading(`${verb} → ${skillsDst}`);
+
+    if (!dryRun) ensureDir(skillsDst);
+    for (const skill of skills) {
+      const dest = join(skillsDst, skill.name);
+      if (!dryRun) {
+        if (existsSync(dest)) rmSync(dest, { recursive: true });
+        copyRecursive(skill.path, dest);
+      }
+      log.success(`${tag}Skill: ${skill.name}`);
+      count++;
+    }
+
+    const rulesDst = join(skillsDst, '_team-rules');
+    if (!dryRun) ensureDir(rulesDst);
+    for (const r of rules) {
+      if (!dryRun) copyFileSync(r.path, join(rulesDst, r.name));
+      log.success(`${tag}Rule: ${r.name}`);
+      count++;
+    }
+  }
+
+  return count;
+}
+
+export function cleanStaleSkills(targetDir, currentNames, { dryRun, exclude = [] }) {
+  if (!existsSync(targetDir)) return;
+  const existing = readdirSync(targetDir).filter(
+    name => !name.startsWith('_') && name !== 'CLAUDE.md' && name.startsWith('team-'),
+  );
+  for (const name of existing) {
+    if (!currentNames.has(name) && !exclude.includes(name)) {
+      const tag = dryRun ? '[dry-run] ' : '';
+      if (!dryRun) rmSync(join(targetDir, name), { recursive: true });
+      log.warn(`${tag}移除旧 Skill: ${name}`);
+    }
+  }
+}