team-skills 1.0.0 → 1.1.1

package/.claude/commands/team-setup.md

@@ -11,7 +11,7 @@ argument-hint: [target-dir]
 
 安装内容：
 
-- `skills/*` → `{target-dir}/`（Agent Skills，含 team-score 评分 Skill 和 using-team-skills meta-skill）
+- `skills/*` → `{target-dir}/`（Agent Skills，含 using-team-skills meta-skill）
 - `skills/_team-rules/*` → `{target-dir}/_team-rules/`（共享规则文件，被所有 Skill 引用）
 - `.claude/commands/*` → `{target-dir}/{name}/SKILL.md`（Commands 也作为 Skill 安装，Cursor 可发现）
 - `.claude/commands/*` → `~/.claude/commands/`（兼容 Claude Code 斜杠命令）

package/README.md

@@ -12,7 +12,7 @@
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](CONTRIBUTING.md)
 [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow?style=flat-square)](https://conventionalcommits.org)
 
-**Spec-Driven · 有向图回退 · 质量门禁 · 100 分制评分**
+**Spec-Driven · 有向图回退 · 质量门禁**
 
 </div>
 
@@ -60,104 +60,87 @@ reviewAgent 发现 spec 遗漏 ──→ 自动回退 specAgent
 - **反规避条款**：预判 6 种常见借口并逐一反驳
 - **三视角对抗审查**：攻击者/怀疑者/用户视角反向验证
 
-### 📊 100 分制评分，不是凭感觉
-
-```
-7 项硬门槛（任一不通过则整体不通过）
-5 个维度 × 25 子项
-每个子项有可检查的证据要求
-```
-
 ---
 
-## 🚀 安装与使用
+## 🚀 安装
 
 ### 前置条件
 
 - **Node.js** >= 18
 - **Claude Code** 或 **Cursor**：至少安装其中之一
 
-### 方式一：npx 安装（推荐）
-
-无需 clone 仓库，直接全局安装 Skills：
+### 一键安装（推荐）
 
 ```bash
-npx team-skills setup
+npx team-skills@latest setup
 ```
 
-### 方式二：clone 后安装
+自动将 Skills、斜杠命令和 Hooks 以 symlink 方式安装到全局目录。
+
+启用可选的项目评分功能（`team-score`）：
 
 ```bash
-git clone https://github.com/andeya/team-skills.git
-cd team-skills
-npm install
-npm run setup
+npx team-skills@latest setup --with-score
 ```
 
-### 方式三：初始化到项目（版本控制）
-
-将 Skills 复制到你的项目中，可以版本控制和自定义：
+如需频繁使用 CLI，可全局安装：
 
 ```bash
-npx team-skills init
-# 或在已 clone 的仓库中
-node bin/team-skills.js init /path/to/your-project
+npm i -g team-skills
+team-skills setup
 ```
 
-这会在项目中创建 `.team-skills/` 目录，包含所有 Skills、Hooks 和命令文件。
+### 初始化到项目（可选）
 
-### 安装内容
+将 Skills 复制到项目中，支持版本控制和自定义：
 
-| 安装内容 | 说明 |
-|----------|------|
-| 12 个 Agent Skills | 安装到 `~/.agents/skills/`，Cursor 自动发现 |
-| 斜杠命令 | 安装到 `~/.claude/commands/`，Claude Code 可用 `/team-{name}` |
-| 共享规则 | `_team-rules/` 被所有 Skill 引用 |
-| Hooks（可选） | session-start 钩子，每次新 session 自动加载 |
+```bash
+npx team-skills@latest init
+# 含评分功能
+npx team-skills@latest init --with-score
+```
 
-### CLI 命令
+自动检测项目中的 `.claude/` 和 `.cursor/` 目录，将对应文件复制到 IDE 能发现的位置。后续更新：
 
-| 命令 | 说明 |
-|------|------|
-| `team-skills setup [target]` | symlink 安装到全局目录（开发者模式） |
-| `team-skills init [dir]` | 复制到用户项目（消费者模式） |
-| `team-skills update [dir]` | 增量更新 init 的副本 |
-| `team-skills uninstall [target]` | 移除所有 symlink |
-| `team-skills list` | 列出已安装 Skills 及状态 |
-| `team-skills --version` | 显示版本 |
+```bash
+npx team-skills@latest update
+```
+
+> **提示**：Hooks 仅在全局安装（`setup`）模式下生效，`init` 不安装 hooks。
 
-所有命令支持 `--dry-run` 查看将执行的操作。
+### 安装内容
 
-### 验证安装
+| 内容 | 位置 | 说明 |
+|------|------|------|
+| 11 个 Agent Skills | `~/.agents/skills/` | Cursor 自动发现 |
+| 斜杠命令 | `~/.claude/commands/` | Claude Code `/team-{name}` |
+| 共享规则 | `~/.agents/skills/_team-rules/` | 被所有 Skill 引用 |
+| Hooks（可选） | `~/.cursor/hooks/` | session-start 自动加载 |
 
-安装后，在聊天框中输入 `/` 查看是否出现 `team-` 开头的命令列表。或使用 CLI 检查：
+### 验证
 
 ```bash
-team-skills list
-
-# 或在 Claude Code / Cursor 中
+# 在 Claude Code / Cursor 中输入 / 查看 team- 开头的命令
 /using-team-skills
-
-# 评估项目协作成熟度
-/team-score
 ```
 
-### 更新 Skills
+### CLI 参考
 
-```bash
-# npx 安装用户
-npx team-skills setup
+| 命令 | 说明 | 关键选项 |
+|------|------|----------|
+| `team-skills setup` | symlink 安装到全局目录 | `--with-score` `--no-hooks` `--force` |
+| `team-skills init [dir]` | 复制到项目 IDE 目录 | `--ide <claude\|cursor\|both>` `--with-score` |
+| `team-skills update [dir]` | 升级包 + 更新项目副本 | `--skip-self` `--ide` `--with-score` |
+| `team-skills uninstall` | 移除所有全局 symlink | `--no-hooks` `--no-commands` |
+| `team-skills list` | 查看全局安装状态 | `--json` |
 
-# 项目内 init 用户
-npx team-skills update
+所有命令支持 `--dry-run`。
 
-# clone 安装用户
-git pull && npm run setup
-```
+---
 
-### 使用方式
+## 📖 使用方式
 
-#### 方式一：全自动编排（推荐）
+### 全自动编排（推荐）
 
 一条命令启动完整流水线，适合从零开始的功能开发：
 
@@ -165,29 +148,15 @@ git pull && npm run setup
 /team-orchestrator 实现用户登录功能
 ```
 
-编排器会自动完成 7 个步骤：
-
-```
-
-1. H1: 向你确认目标理解
-2. specAgent: 产出 SDD 规格
-3. H2: 向你确认规格方案
-4. implAgent: TDD 实现
-5. testAgent: 四维测试
-6. reviewAgent: 五维审查
-7. H4: 向你交付验收
+编排器自动完成：H1 确认目标 → specAgent 产出 SDD → H2 确认规格 → implAgent TDD 实现 → testAgent 四维测试 → reviewAgent 五维审查 → H4 验收交付
 
-```
-
-简单任务可用精简模式（H1 简化为单句确认，跳过 H2，H4 保留）：
+简单任务可用精简模式：
 
 ```bash
 /team-orchestrator --compact 修复登录页按钮样式
 ```
 
-#### 方式二：按需调用单个 Skill
-
-你可以在任意阶段单独调用某个 Skill，适合只想做其中一步的场景：
+### 按需调用单个 Skill
 
 | 场景 | 命令 |
 |------|------|
@@ -202,13 +171,6 @@ git pull && npm run setup
 | 代码写完了 | `/team-finish` |
 | 不知道用哪个 | `/using-team-skills` |
 
-#### 方式三：评估项目成熟度
-
-```bash
-/team-score
-# 输出 100 分制评分报告 + 改进建议
-```
-
 ---
 
 ## 🏗️ 核心架构
@@ -280,7 +242,6 @@ graph TD
     Q -->|"遇到 Bug"| DEBUG[🐛 team-debug<br/>→ 根因分析 + 修复]:::skill
     Q -->|"实现完成，准备合并"| FINISH[🏁 team-finish<br/>→ 合并/PR/清理]:::skill
     Q -->|"声称完成"| VERIFY[✅ team-verify<br/>→ 验证证据链]:::skill
-    Q -->|"评估项目成熟度"| SCORE[📊 team-score<br/>→ 100 分制评分]:::skill
     Q -->|"不知道用哪个"| USING[🧭 using-team-skills<br/>→ Skill 推荐]:::skill
     Q -->|"需要完整交付流水线"| ORCH[⚙️ team-orchestrator<br/>→ 全自动编排]:::orch
 
@@ -301,7 +262,7 @@ graph TD
 
 ---
 
-## 📦 包含 12 个可独立使用的 Skill
+## 📦 包含 11 个可独立使用的 Skill
 
 | Skill | 一句话说明 | 使用场景 |
 |-------|-----------|----------|
@@ -315,7 +276,6 @@ graph TD
 | `team-debug` | 四阶段根因分析 + 修复 | "这个 bug 怎么回事？" |
 | `team-feedback` | 先验证再实施，非表演性同意 | "Review 反馈来了" |
 | `team-finish` | 分支完成处理（合并/PR/保留/丢弃） | "代码写完了" |
-| `team-score` | 100 分制扫描评估 | "项目协作成熟度如何？" |
 | `using-team-skills` | Meta-skill，自动引导你选正确的 Skill | "我该用哪个？" |
 
 > 每个 Skill 可独立使用，也可通过 `team-orchestrator` 串联成完整流水线。
@@ -366,19 +326,15 @@ Team Skills 融合了业界多个 AI 协作框架的精华：
 | **OpenSpec** (Fission AI) | Delta Spec 增量规格、RFC 2119 + Given/When/Then |
 | **Karpathy Skills** | 过度抽象防御、死代码清理、困惑管理 |
 | **Agent-Style** | 5 条 LLM 输出质量约束 |
-| **独创** | 有向图回退、评分追溯矩阵、消费方契约、H1-H4 人类介入点 |
+| **独创** | 有向图回退、质量追溯矩阵、消费方契约、H1-H4 人类介入点 |
 
 ---
 
 ## 🔧 本地开发
 
-### 前置要求
-
-- Node.js >= 18
-
-### 安装依赖
-
 ```bash
+git clone https://github.com/andeya/team-skills.git
+cd team-skills
 npm install
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "team-skills",
-  "version": "1.0.0",
-  "description": "AI Agent Skills framework — Spec-Driven development with directed-graph rollback, quality gates, and 100-point scoring",
+  "version": "1.1.1",
+  "description": "AI Agent Skills framework — Spec-Driven development with directed-graph rollback and quality gates",
   "type": "module",
   "bin": {
     "team-skills": "./bin/team-skills.js"
@@ -20,7 +20,7 @@
   "scripts": {
     "lint": "markdownlint-cli2 '**/*.md' '#node_modules' --config .markdownlint.json && node scripts/check-skill-structure.js",
     "format": "markdownlint-cli2 '**/*.md' '#node_modules' --config .markdownlint.json --fix",
-    "cli-test": "node bin/team-skills.js --version && node bin/team-skills.js list && node bin/team-skills.js setup --dry-run",
+    "cli-test": "node bin/team-skills.js --version && node bin/team-skills.js list && node bin/team-skills.js setup --dry-run && node bin/team-skills.js init --dry-run --ide claude /tmp/test-project && node bin/team-skills.js update --dry-run --skip-self --ide claude /tmp/test-project",
     "prepare": "git config core.hooksPath .githooks 2>/dev/null || true",
     "setup": "node bin/team-skills.js setup",
     "uninstall": "node bin/team-skills.js uninstall"

package/skills/team-orchestrator/SKILL.md

@@ -56,7 +56,7 @@ NO AGENT DISPATCH WITHOUT H1 HUMAN CONFIRMATION FIRST
 - Claude Code：通过 `/team-orchestrator`、`/team-spec`、`/team-impl`、`/team-test`、`/team-review` 调用
 - Cursor：通过 `~/.agents/skills/` 下的 Skill 机制自动发现
 
-<!-- 评分追溯矩阵（内部参考，不产出到文件）
+<!-- 质量检查追溯矩阵（内部参考，不产出到文件）
 硬门槛：
   G1 任务规划    → 01-plan.md
   G2 修改边界    → 04-boundary.md
@@ -65,7 +65,7 @@ NO AGENT DISPATCH WITHOUT H1 HUMAN CONFIRMATION FIRST
   G5 资产可执行  → 12-asset-update.md（消费方契约）+ CLAUDE.md
   G6 风险说明    → 05-risk.md + 11-review.md §四
   G7 决策解释    → 08-ai-decisions.md + 15-brief.md
-评分维度：
+质量维度：
   D1.1 分层组织   → CLAUDE.md + {module}/CLAUDE.md + task-rules.md
   D1.2 内容8类    → 02-context.md + CLAUDE.md + review-checklist + delivery-checklist
   D1.3 规则可执行 → 12-asset-update.md（触发条件+可执行指令+示例）
@@ -231,8 +231,6 @@ NO AGENT DISPATCH WITHOUT H1 HUMAN CONFIRMATION FIRST
 
 判断标准：预计修改文件数 ≤ 3 且无跨模块影响 → Small；修改文件 4-15 → Medium；修改文件 > 15 或跨 2+ 模块 → Large。
 
-> **评分注意**：精简模式跳过 01-plan、02-context、05-risk、14-team、15-brief，无法通过 team-score 满分评估。如需满分评估，使用完整模式。
-
 **精简模式 vs 完整模式对比**：
 
 | 环节 | 完整模式 | 精简模式 |
@@ -479,9 +477,9 @@ NO AGENT DISPATCH WITHOUT H1 HUMAN CONFIRMATION FIRST
 | ---- | ---- | ---- | ----------- | ---- |
 ```
 
-### Step 8：最终质量检查（评分对齐验证）
+### Step 8：最终质量检查
 
-逐条核验，确保每个评分维度都有明确证据。以下清单对齐 team-score 全部评分子项。
+逐条核验，确保每个维度都有明确证据。
 
 **硬门槛（7 项全部必须通过）：**
 
@@ -560,7 +558,7 @@ NO AGENT DISPATCH WITHOUT H1 HUMAN CONFIRMATION FIRST
 Team 全流程完成 ✅
 产出目录：docs/tasks/{slug}/
 文件总数：17 个文档（01-15 + prompt-template + task-rules）+ 代码 + 测试 + 资产更新
-全部质量检查通过（对齐 team-score 全部评分子项）
+全部质量检查通过
 ```
 
 ## 集成关系
@@ -576,9 +574,7 @@ Team 全流程完成 ✅
 - `team-test` — REQUIRED：编排流程中必须调度测试审计
 - `team-review` — REQUIRED：编排流程中必须调度代码审查
 - `team-finish` — 分支完成处理
-- `team-score` — 评估项目协作成熟度
 
 ## 下一步
 
-- 交付完成后，推荐使用 `team-score` 评估项目协作成熟度
 - 如果发现流程问题，更新 `CLAUDE.md` 和 `skills/_team-rules/` 中的规则

package/skills/team-review/SKILL.md

@@ -317,7 +317,7 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK
 3. **新规则沉淀**（§二.5）：列出本次发现的可固化规则，注明写入位置和理由。对每条新规则，必须同时执行写入——追加到目标文件（CLAUDE.md / 模块 CLAUDE.md / task-rules.md），并在 12-asset-update.md 中记录变更
 4. **改进承诺**（§三）：具体行动 + 预期效果
 
-> 重点：§二.5 的新规则沉淀是评分项 D4.4 的关键证据，不可省略。"发现规则但未写入目标文件"视为未完成。
+> 重点：§二.5 的新规则沉淀是质量检查 D4.4 的关键证据，不可省略。"发现规则但未写入目标文件"视为未完成。
 
 ## 产出文件
 

package/skills/using-team-skills/SKILL.md

@@ -56,7 +56,6 @@ NO SKILL RECOMMENDATION WITHOUT SCENE ANALYSIS FIRST
 | 声明完成，需验证门禁 | team-verify |
 | 实现完成，需处理分支 | team-finish |
 | 需完整交付流水线 | team-orchestrator |
-| 评估项目协作成熟度 | team-score |
 
 ## 执行步骤
 
@@ -73,7 +72,6 @@ NO SKILL RECOMMENDATION WITHOUT SCENE ANALYSIS FIRST
 - 收到审查反馈 → 推荐 `team-feedback`
 - 实现完成 → 推荐 `team-finish`
 - 需要完整流水线 → 推荐 `team-orchestrator`
-- 评估成熟度 → 推荐 `team-score`
 
 ### Step 2：推荐并说明理由
 

package/src/commands/init.js

@@ -1,115 +1,80 @@
 import { join } from 'node:path';
-import { existsSync } from 'node:fs';
-import {
-  PACKAGE_ROOT, LOCAL_INSTALL_DIR, SKILLS_DIR, HOOKS_DIR, COMMANDS_DIR,
-} from '../lib/constants.js';
-import { discoverSkills, discoverSharedRules, discoverCommands, discoverHooks, discoverSkillsModuleClaude } from '../lib/inventory.js';
-import { copyRecursive, computeDirectoryHashes, ensureDir } from '../lib/fs-utils.js';
-import { createManifest, writeManifest, readManifest, getPackageVersion } from '../lib/manifest.js';
-import * as log from '../lib/logger.js';
 import { copyFileSync as fsCopyFile } from 'node:fs';
+import { PACKAGE_ROOT } from '../lib/constants.js';
+import { discoverSkills, discoverSharedRules, discoverCommands, discoverSkillsModuleClaude } from '../lib/inventory.js';
+import { copyRecursive, ensureDir } from '../lib/fs-utils.js';
+import { detectIDE } from '../lib/detect-ide.js';
+import * as log from '../lib/logger.js';
 
 export function registerInit(program) {
   program
     .command('init')
-    .description('Copy skills into your project for version-controlled local use')
+    .description('Copy skills into current project for the detected IDE(s)')
     .argument('[dir]', 'Project directory', '.')
-    .option('--no-hooks', 'Skip hooks')
-    .option('--no-commands', 'Skip command files')
+    .option('--ide <type>', 'Force IDE type: claude, cursor, or both')
+    .option('--with-score', 'Include team-score skill (hidden by default)', false)
     .option('--dry-run', 'Show what would be copied', false)
     .action(runInit);
 }
 
 function runInit(dir, opts) {
-  const { hooks, commands, dryRun } = opts;
-  const installDir = join(dir, LOCAL_INSTALL_DIR);
-
-  const existing = readManifest(installDir);
-  if (existing) {
-    log.error(`${installDir} 已存在（v${existing.version}）。使用 team-skills update 更新。`);
-    process.exit(1);
-  }
+  const { ide, withScore, dryRun } = opts;
+  const exclude = withScore ? [] : ['team-score'];
+  const ides = detectIDE(dir, ide, { strict: true });
 
   const tag = dryRun ? '[dry-run] ' : '';
-  let fileCount = 0;
+  let count = 0;
 
   log.heading('初始化 team-skills 到项目');
-  log.info(`目标目录: ${installDir}`);
+  log.info(`项目目录: ${dir}`);
+  log.info(`目标 IDE: ${ides.join(', ')}`);
 
-  // Copy skills/
-  log.heading('复制 Skills');
-  const skillsSrc = join(PACKAGE_ROOT, SKILLS_DIR);
-  const skillsDst = join(installDir, 'skills');
-  if (dryRun) {
-    log.info(`${tag}${skillsSrc} → ${skillsDst}`);
-  } else {
-    copyRecursive(skillsSrc, skillsDst);
-  }
-  const skills = discoverSkills();
+  const skills = discoverSkills(PACKAGE_ROOT, { exclude });
   const rules = discoverSharedRules();
-  fileCount += skills.length + rules.length;
-  for (const s of skills) log.success(`${tag}Skill: ${s.name}`);
-  for (const r of rules) log.success(`${tag}Rule: ${r.name}`);
-
-  // Copy skills/CLAUDE.md if exists
   const skillsClaude = discoverSkillsModuleClaude();
-  if (skillsClaude) {
-    if (!dryRun) {
-      fsCopyFile(skillsClaude, join(skillsDst, 'CLAUDE.md'));
+
+  // 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++;
     }
-    log.success(`${tag}skills/CLAUDE.md`);
-    fileCount++;
-  }
 
-  // Copy hooks/
-  if (hooks !== false) {
-    log.heading('复制 Hooks');
-    const hookFiles = discoverHooks();
-    const hooksDst = join(installDir, 'hooks');
-    if (hookFiles.length > 0) {
-      if (!dryRun) ensureDir(hooksDst);
-      for (const h of hookFiles) {
-        if (!dryRun) {
-          fsCopyFile(h.path, join(hooksDst, h.name));
-        }
-        log.success(`${tag}Hook: ${h.name}`);
-        fileCount++;
-      }
+    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++;
     }
-  }
 
-  // Copy commands/
-  if (commands !== false) {
-    log.heading('复制 Commands');
-    const cmds = discoverCommands();
-    const cmdsDst = join(installDir, 'commands');
-    if (cmds.length > 0) {
-      if (!dryRun) ensureDir(cmdsDst);
-      for (const c of cmds) {
-        if (!dryRun) {
-          fsCopyFile(c.path, join(cmdsDst, c.filename));
-        }
-        log.success(`${tag}Command: ${c.filename}`);
-        fileCount++;
-      }
+    if (skillsClaude) {
+      if (!dryRun) fsCopyFile(skillsClaude, join(skillsDst, 'CLAUDE.md'));
+      log.success(`${tag}skills/CLAUDE.md`);
+      count++;
     }
   }
 
-  // Write manifest
-  if (!dryRun) {
-    const hashes = computeDirectoryHashes(installDir);
-    const manifest = createManifest(getPackageVersion(), hashes);
-    writeManifest(installDir, manifest);
-    log.success('manifest.json 已生成');
-  }
+  // Claude Code: commands → .claude/commands/
+  if (ides.includes('claude')) {
+    const cmdsDst = join(dir, '.claude', 'commands');
+    log.heading(`复制 Commands → ${cmdsDst}`);
 
-  log.done(`初始化完成${dryRun ? ' (dry-run)' : ''}！共 ${fileCount} 个组件。`);
+    const cmds = discoverCommands();
+    if (!dryRun) ensureDir(cmdsDst);
+    for (const c of cmds) {
+      if (!dryRun) fsCopyFile(c.path, join(cmdsDst, c.filename));
+      log.success(`${tag}Command: ${c.filename}`);
+      count++;
+    }
+  }
 
-  console.log(`
-集成说明:
-  Cursor:     将 ${installDir}/skills 设为 agent skills 目录
-  Claude Code: 将 ${installDir}/commands/*.md 链接到 .claude/commands/
-  Hooks:      将 ${installDir}/hooks/ 链接到 ~/.cursor/hooks/ 或 ~/.claude/hooks/
-  更新:       运行 team-skills update
-`);
+  log.done(`初始化完成${dryRun ? ' (dry-run)' : ''}！共 ${count} 个组件。`);
+  log.info('提示：Hooks 仅在全局安装 (setup) 模式下生效，init 不安装 hooks。');
 }

package/src/commands/list.js

@@ -2,11 +2,10 @@ import { join } from 'node:path';
 import { existsSync, readlinkSync } from 'node:fs';
 import {
   DEFAULT_SKILLS_TARGET, DEFAULT_COMMANDS_TARGET,
-  CURSOR_HOOKS_DIR, CLAUDE_HOOKS_DIR, LOCAL_INSTALL_DIR,
+  CURSOR_HOOKS_DIR, CLAUDE_HOOKS_DIR,
 } from '../lib/constants.js';
 import { discoverSkills, discoverSharedRules, discoverCommands, discoverHooks } from '../lib/inventory.js';
 import { isSymlink } from '../lib/fs-utils.js';
-import { readManifest } from '../lib/manifest.js';
 import * as log from '../lib/logger.js';
 
 export function registerList(program) {
@@ -20,7 +19,7 @@ export function registerList(program) {
 
 function runList(opts) {
   const { target, json } = opts;
-  const results = { skills: [], rules: [], commands: [], hooks: [], localInit: null };
+  const results = { skills: [], rules: [], commands: [], hooks: [] };
 
   // Check symlink-based install
   const skills = discoverSkills();
@@ -28,7 +27,6 @@ function runList(opts) {
     const dest = join(target, skill.name);
     results.skills.push({
       name: skill.name,
-      type: 'symlink',
       status: getStatus(dest, skill.path),
       path: dest,
     });
@@ -67,17 +65,6 @@ function runList(opts) {
     }
   }
 
-  // Check for local init
-  const localManifest = readManifest(LOCAL_INSTALL_DIR);
-  if (localManifest) {
-    results.localInit = {
-      version: localManifest.version,
-      installedAt: localManifest.installedAt,
-      sourceCommit: localManifest.sourceCommit,
-      fileCount: Object.keys(localManifest.files).length,
-    };
-  }
-
   if (json) {
     console.log(JSON.stringify(results, null, 2));
     return;
@@ -96,16 +83,8 @@ function runList(opts) {
   log.heading('Hooks');
   printTable(results.hooks);
 
-  if (results.localInit) {
-    log.heading('项目内安装 (.team-skills/)');
-    log.info(`版本: ${results.localInit.version}`);
-    log.info(`安装时间: ${results.localInit.installedAt}`);
-    log.info(`来源 commit: ${results.localInit.sourceCommit}`);
-    log.info(`文件数: ${results.localInit.fileCount}`);
-  }
-
   // Summary
-  const installed = results.skills.filter(s => s.status === 'ok').length;
+  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

@@ -14,18 +14,20 @@ export function registerSetup(program) {
     .argument('[target]', 'Target skills directory', DEFAULT_SKILLS_TARGET)
     .option('--no-hooks', 'Skip hook installation')
     .option('--no-commands', 'Skip Claude Code command symlinks')
+    .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 { hooks, commands, force, dryRun } = opts;
+  const { hooks, commands, withScore, force, dryRun } = opts;
   const tag = dryRun ? '[dry-run] ' : '';
+  const exclude = withScore ? [] : ['team-score'];
   let count = 0;
 
   log.heading('安装 Agent Skills');
-  const skills = discoverSkills();
+  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 });
@@ -84,21 +86,28 @@ function runSetup(target, opts) {
     }
   }
 
-  log.heading('验证安装');
-  let errors = 0;
-  for (const skill of skills) {
-    const dest = join(target, skill.name);
-    if (isSymlink(dest)) {
-      log.success(`${skill.name}`);
-    } else if (!dryRun) {
-      log.error(`${skill.name} 未正确安装`);
-      errors++;
+  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(`Skill: ${skill.name}`, join(target, skill.name));
+    for (const rule of rules) verify(`Rule: ${rule.name}`, join(rulesTarget, rule.name));
+    if (commands !== false) {
+      for (const cmd of discoverCommands()) {
+        verify(`Command: ${cmd.filename}`, join(DEFAULT_COMMANDS_TARGET, cmd.filename));
+      }
+    }
+    if (errors > 0) {
+      log.error(`有 ${errors} 个组件安装异常，请检查。`);
+      process.exit(1);
     }
-  }
-
-  if (errors > 0) {
-    log.error(`有 ${errors} 个组件安装异常，请检查。`);
-    process.exit(1);
   }
 
   log.done(`安装完成！${dryRun ? '(dry-run)' : `共处理 ${count} 个组件。`}`);

package/src/commands/uninstall.js

@@ -13,14 +13,14 @@ export function registerUninstall(program) {
     .command('uninstall')
     .description('Remove all team-skills symlinks')
     .argument('[target]', 'Target skills directory', DEFAULT_SKILLS_TARGET)
-    .option('--keep-hooks', 'Do not remove hooks')
-    .option('--keep-commands', 'Do not remove Claude Code commands')
+    .option('--no-hooks', 'Skip removing hooks')
+    .option('--no-commands', 'Skip removing commands')
     .option('--dry-run', 'Show what would be removed', false)
     .action(runUninstall);
 }
 
 function runUninstall(target, opts) {
-  const { keepHooks, keepCommands, dryRun } = opts;
+  const { hooks, commands, dryRun } = opts;
   let removed = 0;
 
   log.heading('移除 Agent Skills');
@@ -56,7 +56,7 @@ function runUninstall(target, opts) {
   }
   if (!dryRun) rmdirIfEmpty(join(target, '_team-rules'));
 
-  if (!keepCommands) {
+  if (commands !== false) {
     log.heading('移除 Command Skills + Claude Code 命令');
     for (const cmd of discoverCommands()) {
       // Command Skill directory
@@ -88,7 +88,7 @@ function runUninstall(target, opts) {
     }
   }
 
-  if (!keepHooks) {
+  if (hooks !== false) {
     log.heading('移除 Hooks');
     const hookFiles = discoverHooks();
     for (const dir of [CURSOR_HOOKS_DIR, CLAUDE_HOOKS_DIR]) {

package/src/commands/update.js

@@ -1,118 +1,136 @@
 import { join } from 'node:path';
-import { existsSync, readdirSync, statSync, copyFileSync as fsCopyFile } from 'node:fs';
-import { LOCAL_INSTALL_DIR, PACKAGE_ROOT, SKILLS_DIR, HOOKS_DIR, COMMANDS_DIR } from '../lib/constants.js';
-import { computeDirectoryHashes, computeFileHash, ensureDir } from '../lib/fs-utils.js';
-import { readManifest, writeManifest, createManifest, getPackageVersion } from '../lib/manifest.js';
+import { existsSync, copyFileSync as fsCopyFile, rmSync, readdirSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { PACKAGE_ROOT } from '../lib/constants.js';
+import { discoverSkills, discoverSharedRules, discoverCommands, discoverSkillsModuleClaude } from '../lib/inventory.js';
+import { copyRecursive, ensureDir } from '../lib/fs-utils.js';
+import { detectIDE } from '../lib/detect-ide.js';
 import * as log from '../lib/logger.js';
-import { dirname } from 'node:path';
 
 export function registerUpdate(program) {
   program
     .command('update')
-    .description('Update previously init\'d skills to latest version')
+    .description('Upgrade team-skills package and update project installations')
     .argument('[dir]', 'Project directory', '.')
-    .option('--force', 'Overwrite locally modified files (creates .bak backup)', false)
+    .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('--dry-run', 'Show what would change', false)
     .action(runUpdate);
 }
 
-function runUpdate(dir, opts) {
-  const { force, dryRun } = opts;
-  const installDir = join(dir, LOCAL_INSTALL_DIR);
-  const manifest = readManifest(installDir);
+function upgradeSelf(dryRun) {
+  log.heading('升级 team-skills 包');
+  try {
+    const current = execSync(
+      'npm view team-skills version --registry https://registry.npmjs.org 2>/dev/null',
+      { encoding: 'utf8' },
+    ).trim();
+    const local = execSync(
+      `node -e "console.log(require('${join(PACKAGE_ROOT, 'package.json')}').version)"`,
+      { encoding: 'utf8' },
+    ).trim();
+    if (current === local) {
+      log.skip(`已是最新版本 (${local})`);
+      return;
+    }
+    log.info(`${local} → ${current}`);
+    if (!dryRun) {
+      execSync('npm install -g team-skills@latest --registry https://registry.npmjs.org', { stdio: 'inherit' });
+      log.success(`已升级到 ${current}`);
+    } else {
+      log.success(`[dry-run] 将升级到 ${current}`);
+    }
+  } catch {
+    log.warn('自升级跳过（无法访问 npm registry 或非全局安装）');
+  }
+}
 
-  if (!manifest) {
-    log.error(`未找到 ${installDir}/manifest.json。请先运行 team-skills init。`);
-    process.exit(1);
+function cleanStaleSkills(targetDir, currentNames, dryRun) {
+  if (!existsSync(targetDir)) return;
+  const existing = readdirSync(targetDir).filter(
+    name => !name.startsWith('_') && name !== 'CLAUDE.md',
+  );
+  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) {
+  const { ide, withScore, skipSelf, dryRun } = opts;
+
+  if (!skipSelf) upgradeSelf(dryRun);
 
-  const currentVersion = getPackageVersion();
-  log.info(`已安装版本: ${manifest.version} | 最新版本: ${currentVersion}`);
+  const exclude = withScore ? [] : ['team-score'];
+  const ides = detectIDE(dir, ide);
+
+  if (ides.length === 0) {
+    log.info('当前项目未检测到 IDE 配置（.claude/ 或 .cursor/），跳过项目更新。');
+    return;
+  }
 
   const tag = dryRun ? '[dry-run] ' : '';
-  const sourceMap = buildSourceMap();
+  let count = 0;
 
-  let updated = 0;
-  let skipped = 0;
-  let added = 0;
+  log.heading('更新项目中的 team-skills');
+  log.info(`项目目录: ${dir}`);
+  log.info(`目标 IDE: ${ides.join(', ')}`);
 
-  log.heading('检查文件更新');
+  const skills = discoverSkills(PACKAGE_ROOT, { exclude });
+  const rules = discoverSharedRules();
+  const skillsClaude = discoverSkillsModuleClaude();
+  const currentSkillNames = new Set(skills.map(s => s.name));
 
-  for (const [relPath, sourceFullPath] of Object.entries(sourceMap)) {
-    const installedPath = join(installDir, relPath);
-    const sourceHash = computeFileHash(sourceFullPath);
+  // Cursor skills → .cursor/skills/
+  if (ides.includes('cursor')) {
+    const skillsDst = join(dir, '.cursor', 'skills');
+    log.heading(`更新 Skills → ${skillsDst}`);
 
-    if (!existsSync(installedPath)) {
+    cleanStaleSkills(skillsDst, currentSkillNames, dryRun);
+
+    if (!dryRun) ensureDir(skillsDst);
+    for (const skill of skills) {
+      const dest = join(skillsDst, skill.name);
       if (!dryRun) {
-        ensureDir(dirname(installedPath));
-        fsCopyFile(sourceFullPath, installedPath);
+        if (existsSync(dest)) rmSync(dest, { recursive: true });
+        copyRecursive(skill.path, dest);
       }
-      log.success(`${tag}新增: ${relPath}`);
-      added++;
-      continue;
+      log.success(`${tag}Skill: ${skill.name}`);
+      count++;
     }
 
-    const installedHash = computeFileHash(installedPath);
-    if (installedHash === sourceHash) continue;
-
-    const manifestHash = manifest.files[relPath];
-    if (manifestHash && installedHash !== manifestHash && !force) {
-      log.warn(`跳过: ${relPath}（本地已修改，使用 --force 覆盖）`);
-      skipped++;
-      continue;
+    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++;
     }
 
-    if (!dryRun) {
-      if (force && manifestHash && installedHash !== manifestHash) {
-        fsCopyFile(installedPath, installedPath + '.bak');
-        log.info(`备份: ${relPath}.bak`);
-      }
-      fsCopyFile(sourceFullPath, installedPath);
+    if (skillsClaude) {
+      if (!dryRun) fsCopyFile(skillsClaude, join(skillsDst, 'CLAUDE.md'));
+      log.success(`${tag}skills/CLAUDE.md`);
+      count++;
     }
-    log.success(`${tag}更新: ${relPath}`);
-    updated++;
   }
 
-  for (const relPath of Object.keys(manifest.files)) {
-    if (!sourceMap[relPath]) {
-      log.warn(`源文件已删除: ${relPath}（如不再需要请手动删除）`);
+  // Claude Code commands → .claude/commands/
+  if (ides.includes('claude')) {
+    const cmdsDst = join(dir, '.claude', 'commands');
+    log.heading(`更新 Commands → ${cmdsDst}`);
+
+    const cmds = discoverCommands();
+    if (!dryRun) ensureDir(cmdsDst);
+    for (const c of cmds) {
+      if (!dryRun) fsCopyFile(c.path, join(cmdsDst, c.filename));
+      log.success(`${tag}Command: ${c.filename}`);
+      count++;
     }
   }
 
-  if (!dryRun) {
-    const newHashes = computeDirectoryHashes(installDir);
-    delete newHashes['manifest.json'];
-    const newManifest = createManifest(currentVersion, newHashes);
-    writeManifest(installDir, newManifest);
-  }
-
-  log.done(`更新完成${dryRun ? ' (dry-run)' : ''}！更新 ${updated}，新增 ${added}，跳过 ${skipped}。`);
-}
-
-function buildSourceMap() {
-  const map = {};
-
-  const skillsDir = join(PACKAGE_ROOT, SKILLS_DIR);
-  if (existsSync(skillsDir)) scanRecursive(skillsDir, 'skills', map);
-
-  const hooksDir = join(PACKAGE_ROOT, HOOKS_DIR);
-  if (existsSync(hooksDir)) scanRecursive(hooksDir, 'hooks', map);
-
-  const cmdsDir = join(PACKAGE_ROOT, COMMANDS_DIR);
-  if (existsSync(cmdsDir)) scanRecursive(cmdsDir, 'commands', map);
-
-  return map;
-}
-
-function scanRecursive(baseDir, prefix, map) {
-  const entries = readdirSync(baseDir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = join(baseDir, entry.name);
-    const relPath = `${prefix}/${entry.name}`;
-    if (entry.isDirectory()) {
-      scanRecursive(fullPath, relPath, map);
-    } else {
-      map[relPath] = fullPath;
-    }
-  }
+  log.done(`更新完成${dryRun ? ' (dry-run)' : ''}！共 ${count} 个组件。`);
 }

package/src/lib/constants.js

@@ -10,8 +10,6 @@ export const DEFAULT_SKILLS_TARGET = join(homedir(), '.agents', 'skills');
 export const DEFAULT_COMMANDS_TARGET = join(homedir(), '.claude', 'commands');
 export const CURSOR_HOOKS_DIR = join(homedir(), '.cursor', 'hooks');
 export const CLAUDE_HOOKS_DIR = join(homedir(), '.claude', 'hooks');
-export const LOCAL_INSTALL_DIR = '.team-skills';
-export const MANIFEST_FILE = 'manifest.json';
 export const SKILLS_DIR = 'skills';
 export const HOOKS_DIR = 'hooks';
 export const COMMANDS_DIR = join('.claude', 'commands');

package/src/lib/detect-ide.js

@@ -0,0 +1,28 @@
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import * as log from './logger.js';
+
+export function detectIDE(projectDir, forceIDE, { strict = false } = {}) {
+  if (forceIDE) {
+    if (!['claude', 'cursor', 'both'].includes(forceIDE)) {
+      log.error(`不支持的 IDE 类型: ${forceIDE}。可选: claude, cursor, both`);
+      process.exit(1);
+    }
+    return forceIDE === 'both' ? ['claude', 'cursor'] : [forceIDE];
+  }
+
+  const detected = [];
+  if (existsSync(join(projectDir, '.claude'))) detected.push('claude');
+  if (existsSync(join(projectDir, '.cursor'))) detected.push('cursor');
+
+  if (detected.length === 0 && strict) {
+    log.error('未检测到项目级 IDE 配置（.claude/ 或 .cursor/ 目录）。');
+    log.info('请使用 --ide 指定目标 IDE：');
+    log.info('  --ide claude    仅安装 Claude Code 命令');
+    log.info('  --ide cursor    仅安装 Cursor skills');
+    log.info('  --ide both      同时安装两者');
+    process.exit(1);
+  }
+
+  return detected;
+}

package/src/lib/inventory.js

@@ -2,13 +2,14 @@ import { readdirSync, statSync, existsSync } from 'node:fs';
 import { join, basename } from 'node:path';
 import { PACKAGE_ROOT, SKILLS_DIR, HOOKS_DIR, COMMANDS_DIR } from './constants.js';
 
-export function discoverSkills(root = PACKAGE_ROOT) {
+export function discoverSkills(root = PACKAGE_ROOT, { exclude = [] } = {}) {
   const skillsDir = join(root, SKILLS_DIR);
   if (!existsSync(skillsDir)) return [];
 
   return readdirSync(skillsDir)
     .filter(name => {
       if (name.startsWith('_') || name === 'CLAUDE.md') return false;
+      if (exclude.includes(name)) return false;
       const full = join(skillsDir, name);
       return statSync(full).isDirectory();
     })

package/src/lib/manifest.js

@@ -1,45 +0,0 @@
-import { readFileSync, writeFileSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { execSync } from 'node:child_process';
-import { MANIFEST_FILE, PACKAGE_ROOT } from './constants.js';
-
-export function readManifest(dir) {
-  const p = join(dir, MANIFEST_FILE);
-  if (!existsSync(p)) return null;
-  try {
-    return JSON.parse(readFileSync(p, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-export function writeManifest(dir, data) {
-  const p = join(dir, MANIFEST_FILE);
-  writeFileSync(p, JSON.stringify(data, null, 2) + '\n', 'utf8');
-}
-
-export function createManifest(packageVersion, fileHashes) {
-  return {
-    version: packageVersion,
-    installedAt: new Date().toISOString(),
-    sourceCommit: getSourceCommit(),
-    files: fileHashes,
-  };
-}
-
-function getSourceCommit() {
-  try {
-    return execSync('git rev-parse --short HEAD', {
-      cwd: PACKAGE_ROOT,
-      encoding: 'utf8',
-      stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim();
-  } catch {
-    return 'unknown';
-  }
-}
-
-export function getPackageVersion() {
-  const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'));
-  return pkg.version;
-}