Refactor Chinese documentation for team skills and commands

- Removed outdated table of contents from commands-skills.md - Updated skills overview in claude-collaboration.md with new skill names and descriptions - Enhanced clarity and structure of skills details, including roles and pipelines - Added new team skills: team-arch-opt, team-perf-opt, team-brainstorm, team-frontend, team-uidesign, team-issue, team-iterdev, team-quality-assurance, team-roadmap-dev, team-tech-debt, team-ultra-analyze - Improved user command section for better usability - Streamlined best practices for team skills usage
2026-03-03 15:43:11 +08:00 · 2026-03-02 22:49:52 +08:00
parent 99d6438303
commit 1bf9006d65
13 changed files with 1872 additions and 1173 deletions
--- a/docs/zh/features/cli.md
+++ b/docs/zh/features/cli.md
@@ -14,6 +14,58 @@
 | **错误恢复缺失** | 工具失败只能手动重试 | 自动 fallback 到备用模型 |
 | **上下文管理弱** | 多轮对话上下文不连贯 | Native Resume 自动管理 |

+---
+
+## 语义化调用（推荐）
+
+::: tip 核心理念
+CLI 工具是 **AI 自动调用的能力扩展**。用户只需用自然语言描述需求，AI 会自动选择并调用合适的工具。
+:::
+
+### 语义触发示例
+
+只需在对话中自然表达，AI 会自动调用对应工具：
+
+| 目标 | 用户语义描述 | AI 自动执行 |
+| :--- | :--- | :--- |
+| **代码分析** | "用 Gemini 分析 auth 模块的代码结构" | Gemini + 分析规则 |
+| **安全审计** | "用 Gemini 扫描安全漏洞，重点关注 OWASP Top 10" | Gemini + 安全评估规则 |
+| **代码实现** | "让 Qwen 实现一个带缓存的用户仓库" | Qwen + 功能实现规则 |
+| **代码审查** | "用 Codex 审查这个 PR 的改动" | Codex + 审查规则 |
+| **Bug 诊断** | "用 Gemini 分析这个内存泄漏的根因" | Gemini + 诊断规则 |
+
+### 多模型协作模式
+
+通过语义描述，可以让多个 AI 模型协同工作：
+
+| 模式 | 描述方式 | 适用场景 |
+| --- | --- | --- |
+| **协作型** | "让 Gemini 和 Codex 共同分析架构问题" | 多角度分析同一问题 |
+| **流水线型** | "Gemini 设计方案，Qwen 实现，Codex 审查" | 分阶段完成复杂任务 |
+| **迭代型** | "用 Gemini 诊断问题，Codex 修复，迭代直到通过测试" | Bug 修复循环 |
+| **并行型** | "让 Gemini 和 Qwen 分别给出优化建议" | 对比不同方案 |
+
+### 协作示例
+
+**流水线开发**
+```
+用户：我需要实现一个 WebSocket 实时通知功能。
+      请 Gemini 设计架构，Qwen 实现代码，最后用 Codex 审查。
+AI：[依次调用三个模型，完成设计→实现→审查流程]
+```
+
+**迭代修复**
+```
+用户：测试失败了，用 Gemini 诊断原因，让 Qwen 修复，循环直到测试通过。
+AI：[自动迭代诊断-修复流程，直到问题解决]
+```
+
+---
+
+## 底层命令参考
+
+以下是 AI 自动调用时使用的底层命令，用户通常无需手动执行。
+
 ## 核心概念速览

 | 概念 | 说明 | 示例 |
--- a/docs/zh/guide/ch05-advanced-tips.md
+++ b/docs/zh/guide/ch05-advanced-tips.md
@@ -2,255 +2,180 @@

 ## 一句话定位

-**高级技巧是提升效率的关键** — CLI 工具链深度使用、多模型协作优化、记忆管理最佳实践。
+**用自然语言驱动 AI 编排工具链** — 语义化 CLI 调用、多模型协作、智能记忆管理。

 ---

-## 5.1 CLI 工具链使用
+## 5.1 语义化工具调度

-### 5.1.1 CLI 配置
+### 5.1.1 核心理念

-CLI 工具配置文件：`~/.claude/cli-tools.json`
+CCW 的 CLI 工具是 **AI 自动调用的能力扩展**，用户只需用自然语言描述需求，AI 会自动选择并调用合适的工具。
+
+::: tip 关键理解
+- 用户说："用 Gemini 分析这段代码"
+- AI 自动：调用 Gemini CLI + 应用分析规则 + 返回结果
+- 用户无需关心 `ccw cli` 命令细节
+:::
+
+### 5.1.2 可用工具与能力
+
+| 工具 | 擅长领域 | 典型触发词 |
+| --- | --- | --- |
+| **Gemini** | 深度分析、架构设计、Bug 诊断 | "用 Gemini 分析"、"深度理解" |
+| **Qwen** | 代码生成、功能实现 | "让 Qwen 实现"、"代码生成" |
+| **Codex** | 代码审查、Git 操作 | "用 Codex 审查"、"代码评审" |
+| **OpenCode** | 开源多模型 | "用 OpenCode" |
+
+### 5.1.3 语义触发示例
+
+只需在对话中自然表达，AI 会自动调用对应工具：
+
+| 目标 | 用户语义描述 | AI 自动执行 |
+| :--- | :--- | :--- |
+| **安全评估** | "用 Gemini 扫描认证模块的安全漏洞" | Gemini + 安全分析规则 |
+| **代码实现** | "让 Qwen 帮我实现一个速率限制中间件" | Qwen + 功能实现规则 |
+| **代码审查** | "用 Codex 审查这个 PR 的改动" | Codex + 审查规则 |
+| **Bug 诊断** | "用 Gemini 分析这个内存泄漏的根因" | Gemini + 诊断规则 |
+
+### 5.1.4 底层配置（可选了解）
+
+AI 调用工具的配置文件位于 `~/.claude/cli-tools.json`：

 ```json
 {
-  "version": "3.3.0",
  "tools": {
    "gemini": {
      "enabled": true,
      "primaryModel": "gemini-2.5-flash",
-      "secondaryModel": "gemini-2.5-flash",
-      "tags": ["分析", "Debug"],
-      "type": "builtin"
+      "tags": ["分析", "Debug"]
    },
    "qwen": {
      "enabled": true,
      "primaryModel": "coder-model",
-      "secondaryModel": "coder-model",
-      "tags": [],
-      "type": "builtin"
-    },
-    "codex": {
-      "enabled": true,
-      "primaryModel": "gpt-5.2",
-      "secondaryModel": "gpt-5.2",
-      "tags": [],
-      "type": "builtin"
+      "tags": ["实现"]
    }
  }
 }
 ```

-### 5.1.2 标签路由
-
-根据任务类型自动选择模型：
-
-| 标签 | 适用模型 | 任务类型 |
-| --- | --- | --- |
-| **分析** | Gemini | 代码分析、架构设计 |
-| **Debug** | Gemini | 根因分析、问题诊断 |
-| **实现** | Qwen | 功能开发、代码生成 |
-| **审查** | Codex | 代码审查、Git 操作 |
-
-### 5.1.3 CLI 命令模板
-
-#### 分析任务
-
-```bash
-ccw cli -p "PURPOSE: 识别安全漏洞
-TASK: • 扫描 SQL 注入 • 检查 XSS • 验证 CSRF
-MODE: analysis
-CONTEXT: @src/auth/**/*
-EXPECTED: 安全报告，含严重性分级和修复建议
-CONSTRAINTS: 聚焦认证模块" --tool gemini --mode analysis --rule analysis-assess-security-risks
-```
-
-#### 实现任务
-
-```bash
-ccw cli -p "PURPOSE: 实现速率限制
-TASK: • 创建中间件 • 配置路由 • Redis 后端
-MODE: write
-CONTEXT: @src/middleware/**/* @src/config/**/*
-EXPECTED: 生产代码 + 单元测试 + 集成测试
-CONSTRAINTS: 遵循现有中间件模式" --tool qwen --mode write --rule development-implement-feature
-```
-
-### 5.1.4 规则模板
-
-| 规则 | 用途 |
-| --- | --- |
-| **analysis-diagnose-bug-root-cause** | Bug 根因分析 |
-| **analysis-analyze-code-patterns** | 代码模式分析 |
-| **analysis-review-architecture** | 架构审查 |
-| **analysis-assess-security-risks** | 安全评估 |
-| **development-implement-feature** | 功能实现 |
-| **development-refactor-codebase** | 代码重构 |
-| **development-generate-tests** | 测试生成 |
+::: info 说明
+标签（tags）帮助 AI 根据任务类型自动选择最合适的工具。用户通常无需修改此配置。
+:::

 ---

 ## 5.2 多模型协作

-### 5.2.1 模型选择指南
+### 5.2.1 协作模式

-| 任务 | 推荐模型 | 理由 |
+通过语义描述，可以让多个 AI 模型协同工作：
+
+| 模式 | 描述方式 | 适用场景 |
 | --- | --- | --- |
-| **代码分析** | Gemini | 擅长深度代码理解和模式识别 |
+| **协作型** | "让 Gemini 和 Codex 共同分析架构问题" | 多角度分析同一问题 |
+| **流水线型** | "Gemini 设计方案，Qwen 实现，Codex 审查" | 分阶段完成复杂任务 |
+| **迭代型** | "用 Gemini 诊断问题，Codex 修复，迭代直到通过测试" | Bug 修复循环 |
+| **并行型** | "让 Gemini 和 Qwen 分别给出优化建议" | 对比不同方案 |
+
+### 5.2.2 语义示例
+
+**协作分析**
+```
+用户：让 Gemini 和 Codex 共同分析 src/auth 模块的安全性和性能问题
+AI：[自动调用两个模型，综合分析结果]
+```
+
+**流水线开发**
+```
+用户：我需要实现一个 WebSocket 实时通知功能。
+      请 Gemini 设计架构，Qwen 实现代码，最后用 Codex 审查。
+AI：[依次调用三个模型，完成设计→实现→审查流程]
+```
+
+**迭代修复**
+```
+用户：测试失败了，用 Gemini 诊断原因，让 Qwen 修复，循环直到测试通过。
+AI：[自动迭代诊断-修复流程，直到问题解决]
+```
+
+### 5.2.3 模型选择建议
+
+| 任务类型 | 推荐模型 | 理由 |
+| --- | --- | --- |
+| **架构分析** | Gemini | 擅长深度理解和模式识别 |
 | **Bug 诊断** | Gemini | 强大的根因分析能力 |
-| **功能开发** | Qwen | 代码生成效率高 |
-| **代码审查** | Codex (GPT) | Git 集成好，审查格式标准 |
-| **长文本** | Claude | 上下文窗口大 |
-
-### 5.2.2 协作模式
-
-#### 串行协作
-
-```bash
-# 步骤 1: Gemini 分析
-ccw cli -p "分析代码架构" --tool gemini --mode analysis
-
-# 步骤 2: Qwen 实现
-ccw cli -p "基于分析结果实现功能" --tool qwen --mode write
-
-# 步骤 3: Codex 审查
-ccw cli -p "审查实现代码" --tool codex --mode review
-```
-
-#### 并行协作
-
-使用 `--tool gemini` 和 `--tool qwen` 同时分析同一问题：
-
-```bash
-# 终端 1
-ccw cli -p "从性能角度分析" --tool gemini --mode analysis &
-
-# 终端 2
-ccw cli -p "从安全角度分析" --tool codex --mode analysis &
-```
-
-### 5.2.3 会话恢复
-
-跨模型会话恢复：
-
-```bash
-# 第一次调用
-ccw cli -p "分析认证模块" --tool gemini --mode analysis
-
-# 恢复会话继续
-ccw cli -p "基于上次分析，设计改进方案" --tool qwen --mode write --resume
-```
+| **代码生成** | Qwen | 代码生成效率高 |
+| **代码审查** | Codex | Git 集成好，审查格式标准 |
+| **长文本处理** | Claude | 上下文窗口大 |

 ---

-## 5.3 Memory 管理
+## 5.3 智能记忆管理

-### 5.3.1 Memory 分类
+### 5.3.1 记忆系统概述

-| 分类 | 用途 | 示例内容 |
+CCW 的记忆系统是 **AI 自主管理** 的知识库，包括：
+
+| 分类 | 用途 | 示例 |
 | --- | --- | --- |
-| **learnings** | 学习心得 | 新技术使用经验 |
-| **decisions** | 架构决策 | 技术选型理由 |
-| **conventions** | 编码规范 | 命名约定、模式 |
-| **issues** | 已知问题 | Bug、限制、TODO |
+| **learnings** | 学习心得 | 新技术使用经验、最佳实践 |
+| **decisions** | 架构决策 | 技术选型理由、设计权衡 |
+| **conventions** | 编码规范 | 命名约定、代码风格 |
+| **issues** | 已知问题 | Bug 记录、限制说明 |

-### 5.3.2 Memory 命令
+### 5.3.2 记忆的自动使用

-| 命令 | 功能 | 示例 |
-| --- | --- | --- |
-| **list** | 列出所有记忆 | `ccw memory list` |
-| **search** | 搜索记忆 | `ccw memory search "认证"` |
-| **export** | 导出记忆 | `ccw memory export <id>` |
-| **import** | 导入记忆 | `ccw memory import "..."` |
-| **embed** | 生成嵌入 | `ccw memory embed <id>` |
+AI 在执行任务时会自动检索和应用相关记忆：

-### 5.3.3 Memory 最佳实践
-
-::: tip 提示
- **定期整理**: 每周整理一次 Memory，删除过时内容
- **结构化**: 使用标准格式，便于搜索和复用
- **上下文**: 记录决策背景，不只是结论
- **链接**: 相关内容互相引用
-:::
-
-### 5.3.4 Memory 模板
-
-```markdown
-## 标题
-### 背景
- **问题**: ...
- **影响**: ...
-
-### 决策
- **方案**: ...
- **理由**: ...
-
-### 结果
- **效果**: ...
- **经验**: ...
-
-### 相关
- [相关记忆 1](memory-id-1)
- [相关文档](link)
 ```
+用户：帮我实现用户认证模块
+AI：[自动检索记忆中的认证相关 decisions 和 conventions]
+    根据之前的技术决策，我们使用 JWT + bcrypt 方案...
+```
+
+### 5.3.3 用户如何引导记忆
+
+虽然 AI 自动管理记忆，但用户可以主动强化：
+
+**明确要求记住**
+```
+用户：记住这个命名规范：所有 API 路由使用 kebab-case
+AI：[将此规范存入 conventions 记忆]
+```
+
+**要求回顾决策**
+```
+用户：我们之前为什么选择 Redis 做缓存？
+AI：[检索 decisions 记忆并回答]
+```
+
+**纠正错误记忆**
+```
+用户：之前的决定改了，我们现在用 PostgreSQL 代替 MongoDB
+AI：[更新相关 decision 记忆]
+```
+
+### 5.3.4 记忆文件位置
+
+- **全局记忆**: `~/.claude/projects/{project-name}/memory/`
+- **项目记忆**: `.claude/memory/` 或 `MEMORY.md`

 ---

-## 5.4 CodexLens 高级用法
+## 5.4 Hook 自动化

-### 5.4.1 混合搜索
+### 5.4.1 Hook 概念

-结合向量搜索和关键词搜索：
-
-```bash
-# 纯向量搜索
-ccw search --mode vector "用户认证"
-
-# 混合搜索（默认）
-ccw search --mode hybrid "用户认证"
-
-# 纯关键词搜索
-ccw search --mode keyword "authenticate"
-```
-
-### 5.4.2 调用链追踪
-
-追踪函数的完整调用链：
-
-```bash
-# 向上追踪（谁调用了我）
-ccw search --trace-up "authenticateUser"
-
-# 向下追踪（我调用了谁）
-ccw search --trace-down "authenticateUser"
-
-# 完整调用链
-ccw search --trace-full "authenticateUser"
-```
-
-### 5.4.3 语义搜索技巧
-
-| 技巧 | 示例 | 效果 |
-| --- | --- | --- |
-| **功能描述** | "处理用户登录" | 找到登录相关代码 |
-| **问题描述** | "内存泄漏的地方" | 找到潜在问题 |
-| **模式描述** | "单例模式的实现" | 找到设计模式 |
-| **技术描述** | "使用 React Hooks" | 找到相关用法 |
-
---
-
-## 5.5 Hook 自动注入
-
-### 5.5.1 Hook 类型
+Hook 是 AI 执行任务前后的自动化流程，用户无需手动触发：

 | Hook 类型 | 触发时机 | 用途 |
 | --- | --- | --- |
-| **pre-command** | 命令执行前 | 注入规范、加载上下文 |
-| **post-command** | 命令执行后 | 保存 Memory、更新状态 |
+| **pre-command** | AI 思考前 | 加载项目规范、检索记忆 |
+| **post-command** | AI 完成后 | 保存决策、更新索引 |
 | **pre-commit** | Git 提交前 | 代码审查、规范检查 |
-| **file-change** | 文件变更时 | 自动格式化、更新索引 |

-### 5.5.2 Hook 配置
+### 5.4.2 配置示例

 在 `.claude/hooks.json` 中配置：

@@ -258,19 +183,14 @@ ccw search --trace-full "authenticateUser"
 {
  "pre-command": [
    {
-      "name": "inject-specs",
-      "description": "注入项目规范",
+      "name": "load-project-specs",
+      "description": "加载项目规范",
      "command": "cat .workflow/specs/project-constraints.md"
-    },
-    {
-      "name": "load-memory",
-      "description": "加载相关 Memory",
-      "command": "ccw memory search \"{query}\""
    }
  ],
  "post-command": [
    {
-      "name": "save-memory",
+      "name": "save-decisions",
      "description": "保存重要决策",
      "command": "ccw memory import \"{content}\""
    }
@@ -280,49 +200,54 @@ ccw search --trace-full "authenticateUser"

 ---

-## 5.6 性能优化
+## 5.5 ACE 语义搜索

-### 5.6.1 索引优化
+### 5.5.1 什么是 ACE

-| 优化项 | 说明 |
+ACE (Augment Context Engine) 是 AI 的 **代码感知能力**，让 AI 能理解整个代码库的语义。
+
+### 5.5.2 AI 如何使用 ACE
+
+当用户提问时，AI 会自动使用 ACE 搜索相关代码：
+
+```
+用户：认证流程是怎么实现的？
+AI：[通过 ACE 语义搜索 auth 相关代码]
+    根据代码分析，认证流程是...
+```
+
+### 5.5.3 配置参考
+
+| 配置方式 | 链接 |
 | --- | --- |
-| **增量索引** | 只索引变更文件 |
-| **并行索引** | 多进程并行处理 |
-| **缓存策略** | 向量嵌入缓存 |
-
-### 5.6.2 搜索优化
-
-| 优化项 | 说明 |
-| --- | --- |
-| **结果缓存** | 相同查询返回缓存 |
-| **分页加载** | 大结果集分页返回 |
-| **智能去重** | 相似结果自动去重 |
+| **官方文档** | [Augment MCP Documentation](https://docs.augmentcode.com/context-services/mcp/overview) |
+| **代理工具** | [ace-tool (GitHub)](https://github.com/eastxiaodong/ace-tool) |

 ---

-## 5.7 快速参考
+## 5.6 语义提示速查

-### CLI 命令速查
+### 常用语义模式

-| 命令 | 功能 |
+| 目标 | 语义描述示例 |
 | --- | --- |
-| `ccw cli -p "..." --tool gemini --mode analysis` | 分析任务 |
-| `ccw cli -p "..." --tool qwen --mode write` | 实现任务 |
-| `ccw cli -p "..." --tool codex --mode review` | 审查任务 |
-| `ccw memory list` | 列出记忆 |
-| `ccw memory search "..."` | 搜索记忆 |
-| `ccw search "..."` | 语义搜索 |
-| `ccw search --trace "..."` | 调用链追踪 |
+| **分析代码** | "用 Gemini 分析 src/auth 的架构设计" |
+| **安全审计** | "用 Gemini 扫描安全漏洞，重点关注 OWASP Top 10" |
+| **实现功能** | "让 Qwen 实现一个带缓存的用户仓库" |
+| **代码审查** | "用 Codex 审查最近的改动" |
+| **Bug 诊断** | "用 Gemini 分析这个内存泄漏的根因" |
+| **多模型协作** | "Gemini 设计方案，Qwen 实现，Codex 审查" |
+| **记住规范** | "记住：所有 API 使用 RESTful 风格" |
+| **回顾决策** | "我们之前为什么选择这个技术栈？" |

-### 规则模板速查
+### 协作模式速查

-| 规则 | 用途 |
+| 模式 | 语义示例 |
 | --- | --- |
-| `analysis-diagnose-bug-root-cause` | Bug 分析 |
-| `analysis-assess-security-risks` | 安全评估 |
-| `development-implement-feature` | 功能实现 |
-| `development-refactor-codebase` | 代码重构 |
-| `development-generate-tests` | 测试生成 |
+| **协作** | "让 Gemini 和 Codex 共同分析..." |
+| **流水线** | "Gemini 设计，Qwen 实现，Codex 审查" |
+| **迭代** | "诊断并修复，直到测试通过" |
+| **并行** | "让多个模型分别给出建议" |

 ---

--- a/docs/zh/reference/commands-skills.md
+++ b/docs/zh/reference/commands-skills.md
@@ -4,23 +4,6 @@

 ---

-## 目录
-
-1. [主编排器命令](#1-主编排器命令)
-2. [工作流会话命令](#2-工作流会话命令)
-3. [Issue 工作流命令](#3-issue-工作流命令)
-4. [IDAW 命令](#4-idaw-命令)
-5. [With-File 工作流](#5-with-file-工作流)
-6. [循环工作流](#6-循环工作流)
-7. [CLI 命令](#7-cli-命令)
-8. [记忆命令](#8-记忆命令)
-9. [团队技能](#9-团队技能)
-10. [工作流技能](#10-工作流技能)
-11. [实用技能](#11-实用技能)
-12. [Codex 能力](#12-codex-能力)
-
---
-
 ## 快速参考表

 ### 命令快速参考
--- a/docs/zh/skills/claude-collaboration.md
+++ b/docs/zh/skills/claude-collaboration.md
@@ -13,27 +13,78 @@
 | **协作流程割裂** | 团队成员各自为战 | 统一消息总线、共享状态、进度同步 |
 | **资源浪费** | 重复上下文加载 | Wisdom 累积、探索缓存、产物复用 |

-## Skills 列表
+---

-| Skill | 功能 | 触发方式 |
+## Skills 总览
+
+| Skill | 功能 | 适用场景 |
 | --- | --- | --- |
-| `team-coordinate` | 通用团队协调器（动态角色生成） | `/team-coordinate` |
-| `team-lifecycle-v5` | 全生命周期团队（规范→实现→测试→审查） | `/team-lifecycle` |
-| `team-planex` | 规划-执行流水线（边规划边执行） | `/team-planex` |
-| `team-review` | 代码审查团队（扫描→审查→修复） | `/team-review` |
-| `team-testing` | 测试团队（策略→生成→执行→分析） | `/team-testing` |
+| `team-coordinate-v2` | 通用团队协调器（动态角色生成） | 任意复杂任务 |
+| `team-lifecycle-v5` | 全生命周期团队（规范→实现→测试） | 完整功能开发 |
+| `team-planex` | 规划-执行流水线 | Issue 批处理 |
+| `team-review` | 代码审查团队 | 代码审查、漏洞扫描 |
+| `team-testing` | 测试团队 | 测试覆盖、用例生成 |
+| `team-arch-opt` | 架构优化团队 | 重构、架构分析 |
+| `team-perf-opt` | 性能优化团队 | 性能调优、瓶颈分析 |
+| `team-brainstorm` | 头脑风暴团队 | 多角度分析、创意生成 |
+| `team-frontend` | 前端开发团队 | UI 开发、设计系统 |
+| `team-uidesign` | UI 设计团队 | 设计系统、组件规范 |
+| `team-issue` | Issue 处理团队 | Issue 分析、实现 |
+| `team-iterdev` | 迭代开发团队 | 增量交付、敏捷开发 |
+| `team-quality-assurance` | 质量保证团队 | 质量扫描、缺陷管理 |
+| `team-roadmap-dev` | 路线图开发团队 | 分阶段开发、里程碑 |
+| `team-tech-debt` | 技术债务团队 | 债务清理、代码治理 |
+| `team-ultra-analyze` | 深度分析团队 | 复杂问题分析、协作探索 |
+| `team-executor-v2` | 轻量执行器 | 会话恢复、纯执行 |
+
+---
+
+## 核心架构
+
+所有 Team Skills 共享统一的 **team-worker agent 架构**：
+
+```
+┌──────────────────────────────────────────────────────────┐
+│  Skill(skill="team-xxx", args="任务描述")                 │
+└────────────────────────┬─────────────────────────────────┘
+                         │ Role Router
+              ┌──── --role present? ────┐
+              │ NO                      │ YES
+              ↓                         ↓
+       Orchestration Mode         Role Dispatch
+       (auto → coordinator)      (route to role.md)
+              │
+    ┌─────────┴─────────┬───────────────┬──────────────┐
+    ↓                   ↓               ↓              ↓
+┌────────┐         ┌────────┐      ┌────────┐     ┌────────┐
+│ coord  │         │worker 1│      │worker 2│     │worker N│
+│ (编排) │         │(执行)  │      │(执行)  │     │(执行)  │
+└────────┘         └────────┘      └────────┘     └────────┘
+    │                   │               │              │
+    └───────────────────┴───────────────┴──────────────┘
+                         │
+              Message Bus (消息总线)
+```
+
+**核心组件**:
+- **Coordinator**: 内置编排器，负责任务分析、派发、监控
+- **Team-Worker Agent**: 统一代理，加载 role-spec 执行角色逻辑
+- **Role Router**: `--role=xxx` 参数路由到角色执行
+- **Message Bus**: 团队成员间通信协议
+- **Shared Memory**: 跨任务知识累积 (Wisdom)
+
+---

 ## Skills 详解

-### team-coordinate
+### team-coordinate-v2

 **一句话定位**: 通用团队协调器 — 根据任务分析动态生成角色并编排执行

 **触发**:
-```
-/team-coordinate <task-description>
-/team-coordinate --role=coordinator <task>
-/team-coordinate --role=<worker> --session=<path>
+```bash
+team-coordinate <task-description>
+team-coordinate --role=coordinator <task>
 ```

 **功能**:
@@ -42,17 +93,6 @@
 - Fast-Advance 机制跳过协调器直接派生后继任务
 - Wisdom 累积跨任务知识

-**角色注册表**:
-| 角色 | 文件 | 任务前缀 | 类型 |
-|------|------|----------|------|
-| coordinator | roles/coordinator/role.md | (无) | 编排器 |
-| (动态) | `<session>/roles/<role>.md` | (动态) | 工作者 |
-
-**流水线**:
-```
-任务分析 → 生成角色 → 初始化会话 → 创建任务链 → 派生首批工作者 → 循环推进 → 完成报告
-```
-
 **会话目录**:
 ```
 .workflow/.team/TC-<slug>-<date>/
@@ -61,8 +101,6 @@
 ├── roles/                      # 动态角色定义
 ├── artifacts/                  # 所有 MD 交付产物
 ├── wisdom/                     # 跨任务知识
-├── explorations/               # 共享探索缓存
-├── discussions/                # 内联讨论记录
 └── .msg/                       # 团队消息总线日志
 ```

@@ -73,8 +111,8 @@
 **一句话定位**: 全生命周期团队 — 从规范到实现到测试到审查的完整流水线

 **触发**:
-```
-/team-lifecycle <task-description>
+```bash
+team-lifecycle <task-description>
 ```

 **功能**:
@@ -92,164 +130,67 @@
 | executor | role-specs/executor.md | IMPL-* | true |
 | tester | role-specs/tester.md | TEST-* | false |
 | reviewer | role-specs/reviewer.md | REVIEW-* | false |
-| architect | role-specs/architect.md | ARCH-* | false |
-| fe-developer | role-specs/fe-developer.md | DEV-FE-* | false |
-| fe-qa | role-specs/fe-qa.md | QA-FE-* | false |

 **流水线定义**:
 ```
-规范流水线 (6 任务):
-  RESEARCH-001 → DRAFT-001 → DRAFT-002 → DRAFT-003 → DRAFT-004 → QUALITY-001
-
-实现流水线 (4 任务):
-  PLAN-001 → IMPL-001 → TEST-001 + REVIEW-001
-
-全生命周期 (10 任务):
-  [规范流水线] → PLAN-001 → IMPL-001 → TEST-001 + REVIEW-001
-
-前端流水线:
-  PLAN-001 → DEV-FE-001 → QA-FE-001 (GC 循环，最多 2 轮)
+规范流水线:  RESEARCH → DRAFT → QUALITY
+实现流水线:  PLAN → IMPL → TEST + REVIEW
+全生命周期:  [规范流水线] → [实现流水线]
 ```

-**质量关卡** (QUALITY-001 完成后):
-```
-═════════════════════════════════════════
-SPEC PHASE COMPLETE
-Quality Gate: <PASS|REVIEW|FAIL> (<score>%)
-
-Dimension Scores:
-  Completeness:  <bar> <n>%
-  Consistency:   <bar> <n>%
-  Traceability:  <bar> <n>%
-  Depth:         <bar> <n>%
-  Coverage:      <bar> <n>%
-
-Available Actions:
-  resume              -> Proceed to implementation
-  improve             -> Auto-improve weakest dimension
-  improve <dimension> -> Improve specific dimension
-  revise <TASK-ID>    -> Revise specific document
-  recheck             -> Re-run quality check
-  feedback <text>     -> Inject feedback, create revision
-═════════════════════════════════════════
-```
-
-**用户命令** (唤醒暂停的协调器):
-| 命令 | 动作 |
-|------|------|
-| `check` / `status` | 输出执行状态图，不推进 |
-| `resume` / `continue` | 检查工作者状态，推进下一步 |
-| `revise <TASK-ID> [feedback]` | 创建修订任务 + 级联下游 |
-| `feedback <text>` | 分析反馈影响，创建定向修订链 |
-| `recheck` | 重新运行 QUALITY-001 质量检查 |
-| `improve [dimension]` | 自动改进 readiness-report 中最弱维度 |
-
 ---

 ### team-planex

-**一句话定位**: 边规划边执行团队 — 通过逐 Issue 节拍流水线实现 planner 和 executor 并行工作
+**一句话定位**: 边规划边执行团队 — 逐 Issue 节拍流水线

 **触发**:
-```
-/team-planex <task-description>
-/team-planex --role=planner <input>
-/team-planex --role=executor --input <solution-file>
+```bash
+team-planex <task-description>
+team-planex --role=planner <input>
+team-planex --role=executor --input <solution-file>
 ```

 **功能**:
 - 2 成员团队（planner + executor），planner 担任 lead 角色
- 逐 Issue 节拍：planner 每完成一个 issue 的 solution 后立即创建 EXEC-* 任务
+- 逐 Issue 节拍：planner 完成后立即创建 EXEC-* 任务
 - Solution 写入中间产物文件，executor 从文件加载
- 支持多种执行后端（agent/codex/gemini）

-**角色注册表**:
-| 角色 | 文件 | 任务前缀 | 类型 |
-|------|------|----------|------|
-| planner | roles/planner.md | PLAN-* | pipeline (lead) |
-| executor | roles/executor.md | EXEC-* | pipeline |
-
-**输入类型**:
-| 输入类型 | 格式 | 示例 |
-|----------|------|------|
-| Issue IDs | 直接传入 ID | `--role=planner ISS-20260215-001 ISS-20260215-002` |
-| 需求文本 | `--text '...'` | `--role=planner --text '实现用户认证模块'` |
-| Plan 文件 | `--plan path` | `--role=planner --plan plan/2026-02-15-auth.md` |
-
-**Wave Pipeline** (逐 Issue 节拍):
+**Wave Pipeline**:
 ```
-Issue 1:  planner 规划 solution → 写中间产物 → 冲突检查 → 创建 EXEC-* → issue_ready
-                ↓ (executor 立即开始)
-Issue 2:  planner 规划 solution → 写中间产物 → 冲突检查 → 创建 EXEC-* → issue_ready
-                ↓ (executor 并行消费)
-Issue N:  ...
-Final:    planner 发送 all_planned → executor 完成剩余 EXEC-* → 结束
+Issue 1:  planner 规划 → 写产物 → 创建 EXEC-* → executor 执行
+Issue 2:  planner 规划 → 写产物 → 创建 EXEC-* → executor 并行消费
+Final:    planner 发送 all_planned → executor 完成剩余 → 结束
 ```

-**执行方法选择**:
-| 执行器 | 后端 | 适用场景 |
-|--------|------|----------|
-| `agent` | code-developer subagent | 简单任务、同步执行 |
-| `codex` | `ccw cli --tool codex --mode write` | 复杂任务、后台执行 |
-| `gemini` | `ccw cli --tool gemini --mode write` | 分析类任务、后台执行 |
-
-**用户命令**:
-| 命令 | 动作 |
-|------|------|
-| `check` / `status` | 输出执行状态图，不推进 |
-| `resume` / `continue` | 检查工作者状态，推进下一步 |
-| `add <issue-ids or --text '...' or --plan path>` | 追加新任务到 planner 队列 |
-
 ---

 ### team-review

-**一句话定位**: 代码审查团队 — 统一的代码扫描、漏洞审查、优化建议和自动修复
+**一句话定位**: 代码审查团队 — 统一的代码扫描、漏洞审查、自动修复

 **触发**:
+```bash
+team-review <target-path>
+team-review --full <target-path>      # scan + review + fix
+team-review --fix <review-files>      # fix only
+team-review -q <target-path>          # quick scan only
 ```
-/team-review <target-path>
-/team-review --full <target-path>      # scan + review + fix
-/team-review --fix <review-files>      # fix only
-/team-review -q <target-path>          # quick scan only
-```
-
-**功能**:
- 4 角色团队（coordinator, scanner, reviewer, fixer）
- 多维度审查：安全性、正确性、性能、可维护性
- 自动修复循环（审查 → 修复 → 验证）

 **角色注册表**:
-| 角色 | 文件 | 任务前缀 | 类型 |
-|------|------|----------|------|
-| coordinator | roles/coordinator/role.md | RC-* | 编排器 |
-| scanner | roles/scanner/role.md | SCAN-* | 只读分析 |
-| reviewer | roles/reviewer/role.md | REV-* | 只读分析 |
-| fixer | roles/fixer/role.md | FIX-* | 代码生成 |
+| 角色 | 任务前缀 | 类型 |
+|------|----------|------|
+| coordinator | RC-* | 编排器 |
+| scanner | SCAN-* | 只读分析 |
+| reviewer | REV-* | 只读分析 |
+| fixer | FIX-* | 代码生成 |

-**流水线** (CP-1 Linear):
+**流水线**:
 ```
-coordinator dispatch
-  → SCAN-* (scanner: 工具链 + LLM 扫描)
-  → REV-*  (reviewer: 深度分析 + 报告)
-  → [用户确认]
-  → FIX-*  (fixer: 规划 + 执行 + 验证)
+SCAN-* (扫描) → REV-* (审查) → [用户确认] → FIX-* (修复)
 ```

-**检查点**:
-| 触发 | 位置 | 行为 |
-|------|------|------|
-| Review→Fix 过渡 | REV-* 完成 | 暂停，展示审查报告，等待用户 `resume` 确认修复 |
-| 快速模式 (`-q`) | SCAN-* 后 | 流水线在扫描后结束，无审查/修复 |
-| 仅修复模式 (`--fix`) | 入口 | 跳过扫描/审查，直接进入 fixer |
-
-**审查维度**:
-| 维度 | 检查点 |
-|------|--------|
-| 安全性 (sec) | 注入漏洞、敏感信息泄露、权限控制 |
-| 正确性 (cor) | 边界条件、错误处理、类型安全 |
-| 性能 (perf) | 算法复杂度、I/O 优化、资源使用 |
-| 可维护性 (maint) | 代码结构、命名规范、注释质量 |
+**审查维度**: 安全性、正确性、性能、可维护性

 ---

@@ -258,75 +199,318 @@ coordinator dispatch
 **一句话定位**: 测试团队 — 通过 Generator-Critic 循环实现渐进式测试覆盖

 **触发**:
+```bash
+team-testing <task-description>
 ```
-/team-testing <task-description>
-```
-
-**功能**:
- 5 角色团队（coordinator, strategist, generator, executor, analyst）
- 三种流水线：Targeted、Standard、Comprehensive
- Generator-Critic 循环自动改进测试覆盖率

 **角色注册表**:
-| 角色 | 文件 | 任务前缀 | 类型 |
-|------|------|----------|------|
-| coordinator | roles/coordinator.md | (无) | 编排器 |
-| strategist | roles/strategist.md | STRATEGY-* | pipeline |
-| generator | roles/generator.md | TESTGEN-* | pipeline |
-| executor | roles/executor.md | TESTRUN-* | pipeline |
-| analyst | roles/analyst.md | TESTANA-* | pipeline |
+| 角色 | 任务前缀 | 类型 |
+|------|----------|------|
+| coordinator | (无) | 编排器 |
+| strategist | STRATEGY-* | pipeline |
+| generator | TESTGEN-* | pipeline |
+| executor | TESTRUN-* | pipeline |
+| analyst | TESTANA-* | pipeline |

 **三种流水线**:
 ```
-Targeted (小范围变更):
-  STRATEGY-001 → TESTGEN-001(L1 unit) → TESTRUN-001
-
-Standard (渐进式):
-  STRATEGY-001 → TESTGEN-001(L1) → TESTRUN-001(L1) → TESTGEN-002(L2) → TESTRUN-002(L2) → TESTANA-001
-
-Comprehensive (完整覆盖):
-  STRATEGY-001 → [TESTGEN-001(L1) + TESTGEN-002(L2)](并行) → [TESTRUN-001(L1) + TESTRUN-002(L2)](并行) → TESTGEN-003(L3) → TESTRUN-003(L3) → TESTANA-001
+Targeted:   STRATEGY → TESTGEN(L1) → TESTRUN
+Standard:   STRATEGY → TESTGEN(L1) → TESTRUN → TESTGEN(L2) → TESTRUN → TESTANA
+Comprehensive: STRATEGY → [TESTGEN(L1+L2) 并行] → [TESTRUN 并行] → TESTGEN(L3) → TESTRUN → TESTANA
 ```

-**Generator-Critic 循环**:
-```
-TESTGEN → TESTRUN → (如果覆盖率 < 目标) → TESTGEN-fix → TESTRUN-2
-                     (如果覆盖率 >= 目标) → 下一层或 TESTANA
+**测试层**: L1: Unit (80%) → L2: Integration (60%) → L3: E2E (40%)
+
+---
+
+### team-arch-opt
+
+**一句话定位**: 架构优化团队 — 分析架构问题、设计重构策略、实施改进
+
+**触发**:
+```bash
+team-arch-opt <task-description>
 ```

-**测试层定义**:
-| 层级 | 覆盖目标 | 示例 |
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
 |------|----------|------|
-| L1: Unit | 80% | 单元测试、函数级测试 |
-| L2: Integration | 60% | 集成测试、模块间交互 |
-| L3: E2E | 40% | 端到端测试、用户场景 |
+| coordinator | (无) | 编排器 |
+| analyzer | ANALYZE-* | 架构分析 |
+| designer | DESIGN-* | 重构设计 |
+| refactorer | REFACT-* | 实施重构 |
+| validator | VALID-* | 验证改进 |
+| reviewer | REVIEW-* | 代码审查 |

-**共享内存** (shared-memory.json):
-| 角色 | 字段 |
+**检测范围**: 依赖循环、耦合/内聚、分层违规、上帝类、死代码
+
+---
+
+### team-perf-opt
+
+**一句话定位**: 性能优化团队 — 性能分析、瓶颈识别、优化实施
+
+**触发**:
+```bash
+team-perf-opt <task-description>
+```
+
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
+|------|----------|------|
+| coordinator | (无) | 编排器 |
+| profiler | PROFILE-* | 性能分析 |
+| strategist | STRAT-* | 优化策略 |
+| optimizer | OPT-* | 实施优化 |
+| benchmarker | BENCH-* | 基准测试 |
+| reviewer | REVIEW-* | 代码审查 |
+
+---
+
+### team-brainstorm
+
+**一句话定位**: 头脑风暴团队 — 多角度创意分析、Generator-Critic 循环
+
+**触发**:
+```bash
+team-brainstorm <topic>
+team-brainstorm --role=ideator <topic>
+```
+
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
+|------|----------|------|
+| coordinator | (无) | 编排器 |
+| ideator | IDEA-* | 创意生成 |
+| challenger | CHALLENGE-* | 批判质疑 |
+| synthesizer | SYNTH-* | 综合整合 |
+| evaluator | EVAL-* | 评估评分 |
+
+---
+
+### team-frontend
+
+**一句话定位**: 前端开发团队 — 内置 ui-ux-pro-max 设计智能
+
+**触发**:
+```bash
+team-frontend <task-description>
+```
+
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
+|------|----------|------|
+| coordinator | (无) | 编排器 |
+| analyst | ANALYZE-* | 需求分析 |
+| architect | ARCH-* | 架构设计 |
+| developer | DEV-* | 前端实现 |
+| qa | QA-* | 质量保证 |
+
+---
+
+### team-uidesign
+
+**一句话定位**: UI 设计团队 — 设计系统分析、Token 定义、组件规范
+
+**触发**:
+```bash
+team-uidesign <task>
+```
+
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
+|------|----------|------|
+| coordinator | (无) | 编排器 |
+| researcher | RESEARCH-* | 设计研究 |
+| designer | DESIGN-* | 设计定义 |
+| reviewer | AUDIT-* | 无障碍审计 |
+| implementer | BUILD-* | 代码实现 |
+
+---
+
+### team-issue
+
+**一句话定位**: Issue 处理团队 — Issue 处理流水线
+
+**触发**:
+```bash
+team-issue <issue-ids>
+```
+
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
+|------|----------|------|
+| coordinator | (无) | 编排器 |
+| explorer | EXPLORE-* | 代码探索 |
+| planner | PLAN-* | 方案规划 |
+| implementer | IMPL-* | 代码实现 |
+| reviewer | REVIEW-* | 代码审查 |
+| integrator | INTEG-* | 集成验证 |
+
+---
+
+### team-iterdev
+
+**一句话定位**: 迭代开发团队 — Generator-Critic 循环、增量交付
+
+**触发**:
+```bash
+team-iterdev <task-description>
+```
+
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
+|------|----------|------|
+| coordinator | (无) | 编排器 |
+| architect | ARCH-* | 架构设计 |
+| developer | DEV-* | 功能开发 |
+| tester | TEST-* | 测试验证 |
+| reviewer | REVIEW-* | 代码审查 |
+
+**特点**: Developer-Reviewer 循环（最多 3 轮），Task Ledger 实时进度
+
+---
+
+### team-quality-assurance
+
+**一句话定位**: 质量保证团队 — Issue 发现 + 测试验证闭环
+
+**触发**:
+```bash
+team-quality-assurance <task-description>
+team-qa <task-description>
+```
+
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
+|------|----------|------|
+| coordinator | (无) | 编排器 |
+| scout | SCOUT-* | 问题发现 |
+| strategist | QASTRAT-* | 策略制定 |
+| generator | QAGEN-* | 测试生成 |
+| executor | QARUN-* | 测试执行 |
+| analyst | QAANA-* | 结果分析 |
+
+---
+
+### team-roadmap-dev
+
+**一句话定位**: 路线图开发团队 — 分阶段开发、里程碑管理
+
+**触发**:
+```bash
+team-roadmap-dev <task-description>
+```
+
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
+|------|----------|------|
+| coordinator | (无) | 人机交互 |
+| planner | PLAN-* | 阶段规划 |
+| executor | EXEC-* | 阶段执行 |
+| verifier | VERIFY-* | 阶段验证 |
+
+---
+
+### team-tech-debt
+
+**一句话定位**: 技术债务团队 — 债务扫描、评估、清理、验证
+
+**触发**:
+```bash
+team-tech-debt <task-description>
+```
+
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
+|------|----------|------|
+| coordinator | (无) | 编排器 |
+| scanner | TDSCAN-* | 债务扫描 |
+| assessor | TDEVAL-* | 量化评估 |
+| planner | TDPLAN-* | 治理规划 |
+| executor | TDFIX-* | 清理执行 |
+| validator | TDVAL-* | 验证回归 |
+
+---
+
+### team-ultra-analyze
+
+**一句话定位**: 深度分析团队 — 多角色协作探索、渐进式理解
+
+**触发**:
+```bash
+team-ultra-analyze <topic>
+team-analyze <topic>
+```
+
+**角色注册表**:
+| 角色 | 任务前缀 | 功能 |
+|------|----------|------|
+| coordinator | (无) | 编排器 |
+| explorer | EXPLORE-* | 代码探索 |
+| analyst | ANALYZE-* | 深度分析 |
+| discussant | DISCUSS-* | 讨论交互 |
+| synthesizer | SYNTH-* | 综合输出 |
+
+**特点**: 支持 Quick/Standard/Deep 三种深度模式
+
+---
+
+### team-executor-v2
+
+**一句话定位**: 轻量执行器 — 恢复会话、纯执行模式
+
+**触发**:
+```bash
+team-executor --session=<path>
+```
+
+**功能**:
+- 无分析、无角色生成 — 仅加载并执行现有会话
+- 用于恢复中断的 team-coordinate 会话
+
+---
+
+## 用户命令
+
+所有 Team Skills 支持统一的用户命令（唤醒暂停的协调器）：
+
+| 命令 | 动作 |
 |------|------|
-| strategist | `test_strategy` |
-| generator | `generated_tests` |
-| executor | `execution_results`, `defect_patterns` |
-| analyst | `analysis_report`, `coverage_history` |
+| `check` / `status` | 输出执行状态图，不推进 |
+| `resume` / `continue` | 检查工作者状态，推进下一步 |
+| `revise <TASK-ID>` | 创建修订任务 + 级联下游 |
+| `feedback <text>` | 分析反馈影响，创建定向修订链 |
+
+---
+
+## 最佳实践
+
+1. **选择合适的团队类型**:
+   - 通用任务 → `team-coordinate-v2`
+   - 完整功能开发 → `team-lifecycle-v5`
+   - Issue 批处理 → `team-planex`
+   - 代码审查 → `team-review`
+   - 测试覆盖 → `team-testing`
+   - 架构优化 → `team-arch-opt`
+   - 性能调优 → `team-perf-opt`
+   - 头脑风暴 → `team-brainstorm`
+   - 前端开发 → `team-frontend`
+   - UI 设计 → `team-uidesign`
+   - 技术债务 → `team-tech-debt`
+   - 深度分析 → `team-ultra-analyze`
+
+2. **利用内循环角色**: 设置 `inner_loop: true` 让单个工作者处理多个同前缀任务
+
+3. **Wisdom 累积**: 团队会话中的所有角色都会累积知识到 `wisdom/` 目录
+
+4. **Fast-Advance**: 简单线性后继任务会自动跳过协调器直接派生
+
+5. **断点恢复**: 所有团队技能支持会话恢复，通过 `--resume` 或 `resume` 命令继续
+
+---

 ## 相关命令

 - [Claude Commands - Workflow](../commands/claude/workflow.md)
 - [Claude Commands - Session](../commands/claude/session.md)
-
-## 最佳实践
-
-1. **选择合适的团队类型**:
-   - 通用任务 → `team-coordinate`
-   - 完整功能开发 → `team-lifecycle`
-   - Issue 批处理 → `team-planex`
-   - 代码审查 → `team-review`
-   - 测试覆盖 → `team-testing`
-
-2. **利用内循环角色**: 对于有多个同前缀串行任务的角色，设置 `inner_loop: true` 让单个工作者处理全部任务，避免重复派生开销
-
-3. **Wisdom 累积**: 团队会话中的所有角色都会累积知识到 `wisdom/` 目录，后续任务可复用这些模式、决策和约定
-
-4. **Fast-Advance**: 简单线性后继任务会自动跳过协调器直接派生，减少协调开销
-
-5. **断点恢复**: 所有团队技能支持会话恢复，通过 `--resume` 或用户命令 `resume` 继续中断的会话