team-skills 1.0.0 → 1.1.0

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,77 @@ 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 方式安装到全局目录。
+
+如需频繁使用 CLI，可全局安装：
 
 ```bash
-git clone https://github.com/andeya/team-skills.git
-cd team-skills
-npm install
-npm run setup
+npm i -g team-skills
+team-skills setup
 ```
 
-### 方式三：初始化到项目（版本控制）
+### 初始化到项目（可选）
 
-将 Skills 复制到你的项目中，可以版本控制和自定义：
+将 Skills 复制到项目中，支持版本控制和自定义：
 
 ```bash
-npx team-skills init
-# 或在已 clone 的仓库中
-node bin/team-skills.js init /path/to/your-project
+npx team-skills@latest init
 ```
 
-这会在项目中创建 `.team-skills/` 目录，包含所有 Skills、Hooks 和命令文件。
-
-### 安装内容
-
-| 安装内容 | 说明 |
-|----------|------|
-| 12 个 Agent Skills | 安装到 `~/.agents/skills/`，Cursor 自动发现 |
-| 斜杠命令 | 安装到 `~/.claude/commands/`，Claude Code 可用 `/team-{name}` |
-| 共享规则 | `_team-rules/` 被所有 Skill 引用 |
-| Hooks（可选） | session-start 钩子，每次新 session 自动加载 |
-
-### CLI 命令
+创建 `.team-skills/` 目录，包含 Skills、Hooks 和命令文件。后续更新：
 
-| 命令 | 说明 |
-|------|------|
-| `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
+```
 
-所有命令支持 `--dry-run` 查看将执行的操作。
+### 安装内容
 
-### 验证安装
+| 内容 | 位置 | 说明 |
+|------|------|------|
+| 12 个 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 安装到全局目录 |
+| `team-skills init [dir]` | 复制到项目目录 |
+| `team-skills update [dir]` | 增量更新项目副本 |
+| `team-skills uninstall` | 移除所有 symlink |
+| `team-skills list` | 查看安装状态 |
 
-# 项目内 init 用户
-npx team-skills update
+所有命令支持 `--dry-run`。
 
-# clone 安装用户
-git pull && npm run setup
-```
+---
 
-### 使用方式
+## 📖 使用方式
 
-#### 方式一：全自动编排（推荐）
+### 全自动编排（推荐）
 
 一条命令启动完整流水线，适合从零开始的功能开发：
 
@@ -165,29 +138,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 +161,6 @@ git pull && npm run setup
 | 代码写完了 | `/team-finish` |
 | 不知道用哪个 | `/using-team-skills` |
 
-#### 方式三：评估项目成熟度
-
-```bash
-/team-score
-# 输出 100 分制评分报告 + 改进建议
-```
-
 ---
 
 ## 🏗️ 核心架构
@@ -280,7 +232,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 +252,7 @@ graph TD
 
 ---
 
-## 📦 包含 12 个可独立使用的 Skill
+## 📦 包含 11 个可独立使用的 Skill
 
 | Skill | 一句话说明 | 使用场景 |
 |-------|-----------|----------|
@@ -315,7 +266,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 +316,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,6 +1,6 @@
 {
   "name": "team-skills",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "AI Agent Skills framework — Spec-Driven development with directed-graph rollback, quality gates, and 100-point scoring",
   "type": "module",
   "bin": {

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

@@ -16,13 +16,15 @@ export function registerInit(program) {
     .argument('[dir]', 'Project directory', '.')
     .option('--no-hooks', 'Skip hooks')
     .option('--no-commands', 'Skip command files')
+    .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 { hooks, commands, withScore, dryRun } = opts;
   const installDir = join(dir, LOCAL_INSTALL_DIR);
+  const exclude = withScore ? [] : ['team-score'];
 
   const existing = readManifest(installDir);
   if (existing) {
@@ -38,15 +40,16 @@ function runInit(dir, opts) {
 
   // 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();
+  if (!dryRun) {
+    ensureDir(skillsDst);
+    for (const s of skills) copyRecursive(s.path, join(skillsDst, s.name));
+    const rulesDst = join(skillsDst, '_team-rules');
+    ensureDir(rulesDst);
+    for (const r of rules) fsCopyFile(r.path, join(rulesDst, r.name));
+  }
   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}`);

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

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();
     })