team-skills 1.3.2 → 1.3.4

package/CHANGELOG.md

@@ -7,6 +7,28 @@
 
 ## [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
+
+### 变更
+
+- `update` 命令新增全局安装阶段：同步更新 `~/.agents/skills/` 和 `~/.claude/skills/`（含 team-score）
+- `setup` 全局安装始终包含 team-score，移除 `--with-score` 参数
+- `setup`、`init`、`update` 统一为默认覆盖模式，移除 `--force` 参数
+- `init` 覆盖行为与 `update` 对齐：先清理再复制（`rmSync` + `copyRecursive`）
+
+### 修复
+
+- `update` 不再误删项目中已安装的 team-score（`cleanStaleSkills` 跳过被排除的 skill）
+- `setup` 验证阶段补全 Claude Code 共享规则检查（之前仅验证 Cursor 路径）
+- `update` 全局安装新增 symlink 验证阶段
+
 ## [1.3.2] - 2026-06-26
 
 ### 新增

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "team-skills",
-  "version": "1.3.2",
+  "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 } 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,59 +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) 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) 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) {
@@ -11,78 +8,20 @@ export function registerSetup(program) {
     .command('setup')
     .description('Install skills via symlinks to global directories')
     .argument('[target]', 'Target skills directory', DEFAULT_SKILLS_TARGET)
-    .option('--with-score', 'Include team-score skill (hidden by default)', false)
-    .option('--force', 'Overwrite existing symlinks', false)
     .option('--dry-run', 'Show what would be done without doing it', false)
     .action(runSetup);
 }
 
 function runSetup(target, opts) {
-  const { withScore, force, dryRun } = opts;
-  const tag = dryRun ? '[dry-run] ' : '';
-  const exclude = withScore ? [] : ['team-score'];
-  let count = 0;
-
-  // Skills → ~/.agents/skills/ (Cursor auto-discovers from here)
-  log.heading('安装 Skills → Cursor');
-  const skills = discoverSkills(PACKAGE_ROOT, { exclude });
-  for (const skill of skills) {
-    const dest = join(target, skill.name);
-    const result = createSymlinkSafe(skill.path, dest, { force, dryRun });
-    logResult(`${tag}Skill: ${skill.name}`, result, dest);
-    if (result === 'created' || result === 'dry-run') count++;
-  }
-
-  // Shared rules → ~/.agents/skills/_team-rules/
-  log.heading('安装共享规则');
+  const { dryRun } = opts;
+  const skills = discoverSkills(PACKAGE_ROOT);
   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, dryRun });
-    logResult(`${tag}Rule: ${rule.name}`, result, dest);
-    if (result === 'created' || result === 'dry-run') count++;
-  }
+  const targets = resolveTargets(target);
 
-  // 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, dryRun });
-    logResult(`${tag}Skill: ${skill.name}`, result, dest);
-    if (result === 'created' || result === 'dry-run') count++;
-  }
-
-  // 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, dryRun });
-    logResult(`${tag}Rule: ${rule.name}`, result, dest);
-    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));
+    const errors = verifyGlobalSymlinks(targets, skills, rules);
     if (errors > 0) {
       log.error(`有 ${errors} 个组件安装异常，请检查。`);
       process.exit(1);
@@ -94,20 +33,3 @@ function runSetup(target, opts) {
     console.log('\n后续可通过 team-skills setup 重新安装，或 team-skills uninstall 卸载。');
   }
 }
-
-function logResult(label, result, dest) {
-  switch (result) {
-    case 'created':
-    case 'dry-run':
-      log.success(label);
-      break;
-    case 'exists':
-      log.skip(`${label}（已存在，跳过）`);
-      break;
-    case 'conflict':
-      log.warn(`${label}（已存在非 symlink，使用 --force 覆盖）`);
-      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,20 +1,23 @@
 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 } 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 } 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) {
   program
     .command('update')
-    .description('Upgrade team-skills package and update project installations')
+    .description('Upgrade team-skills package and update global & project installations')
     .argument('[dir]', 'Project directory', '.')
     .option('--ide <type>', 'Force IDE type: claude, cursor, or both')
-    .option('--with-score', 'Include team-score skill (hidden by default)', false)
-    .option('--skip-self', 'Skip self-upgrade, only update project', false)
+    .option('--with-score', 'Include team-score skill in project (hidden by default)', false)
+    .option('--skip-self', 'Skip self-upgrade, only update installations', false)
     .option('--dry-run', 'Show what would change', false)
     .action(runUpdate);
 }
@@ -45,98 +48,50 @@ function upgradeSelf(dryRun) {
   }
 }
 
-function cleanStaleSkills(targetDir, currentNames, dryRun) {
-  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)) {
-      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 ides = detectIDE(dir, ide);
+  const allSkills = discoverSkills(PACKAGE_ROOT);
+  const rules = discoverSharedRules();
+  const allSkillNames = new Set(allSkills.map(s => s.name));
 
+  log.heading('更新全局 Skills');
+  for (const t of GLOBAL_TARGETS) {
+    cleanStaleSkills(t.dir, allSkillNames, { dryRun });
+  }
+  let count = installSkillsGlobal(GLOBAL_TARGETS, allSkills, rules, { dryRun, verb: '更新' });
+
+  if (!dryRun) {
+    const errors = verifyGlobalSymlinks(GLOBAL_TARGETS, allSkills, rules);
+    if (errors > 0) {
+      log.error(`有 ${errors} 个全局组件安装异常，请检查。`);
+    }
+  }
+
+  const ides = detectIDE(dir, ide);
   if (ides.length === 0) {
     log.info('当前项目未检测到 IDE 配置（.claude/ 或 .cursor/），跳过项目更新。');
+    log.done(`更新完成${dryRun ? ' (dry-run)' : ''}！共 ${count} 个组件。`);
     return;
   }
 
-  const tag = dryRun ? '[dry-run] ' : '';
-  let count = 0;
+  const exclude = withScore ? [] : ['team-score'];
+  const projectSkills = discoverSkills(PACKAGE_ROOT, { exclude });
+  const projectSkillNames = new Set(projectSkills.map(s => s.name));
 
   log.heading('更新项目中的 team-skills');
   log.info(`项目目录: ${dir}`);
   log.info(`目标 IDE: ${ides.join(', ')}`);
 
-  const skills = discoverSkills(PACKAGE_ROOT, { exclude });
-  const rules = discoverSharedRules();
-  const currentSkillNames = new Set(skills.map(s => s.name));
-
-  // Cursor: skills → .cursor/skills/
-  if (ides.includes('cursor')) {
-    const skillsDst = join(dir, '.cursor', 'skills');
-    log.heading(`更新 Skills → ${skillsDst}`);
-
-    cleanStaleSkills(skillsDst, currentSkillNames, dryRun);
-
-    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++;
-    }
+  for (const ideName of ides) {
+    const skillsDst = join(dir, PROJECT_IDE_DIRS[ideName], 'skills');
+    cleanStaleSkills(skillsDst, projectSkillNames, { dryRun, exclude });
   }
 
-  // Claude Code: skills → .claude/skills/ (same structure as Cursor)
-  if (ides.includes('claude')) {
-    const skillsDst = join(dir, '.claude', 'skills');
-    log.heading(`更新 Skills → ${skillsDst}`);
-
-    cleanStaleSkills(skillsDst, currentSkillNames, dryRun);
-
-    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++;
-    }
-  }
+  count += installSkillsProject(dir, ides, projectSkills, rules, { dryRun, verb: '更新' });
 
   log.done(`更新完成${dryRun ? ' (dry-run)' : ''}！共 ${count} 个组件。`);
 }

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}`);
+    }
+  }
+}