Team Creator
交互式的 Claude Code Teams 配置生成器，通过灵活的问答式引导帮助用户快速创建专业的团队配置文件。
功能特性
✨ 混合模式: 模板快速启动 + 深度定制 📋 多格式输出: YAML 配置 + Markdown 文档 + 角色详细定义 🎯 智能推荐: 基于项目类型和技术栈的智能建议 🔧 灵活交互: 多选 + 自定义输入 📚 丰富模板: 10+ 种预设团队模板 🤖 50+ 角色: 涵盖开发、测试、运维、数据、AI 等领域
使用场景
当用户需要以下操作时使用此技能：
- 创建新的 Claude Code Teams 配置
- 为新项目设置团队结构
- 优化现有团队配置
- 了解团队配置最佳实践
工作流程
按顺序执行以下 6 个阶段，使用 AskUserQuestion 工具进行交互：
阶段 1：模板选择
收集项目信息，匹配合适的模板。
问题 1: 项目类型（多选）
- 前端项目、后端项目、Web 全栈应用
- AI/ML 平台、移动应用、数据平台/BI
- 微服务架构、SaaS 产品、电商平台、企业管理系统
问题 2: 团队规模（单选）
- 个人开发者（1人）
- 小型团队（2-5人）
- 中型团队（6-15人）
- 大型团队（16-30人）
- 企业级团队（30+人）
- 不确定，需要根据项目复杂度推荐
问题 3: 技术栈（多选）
- 后端：Python、Java (Spring Boot/Cloud)、Node.js、Go、.NET Core、Ruby
- 前端：React/Next.js、Vue/Nuxt、Angular、Svelte
- 数据库：PostgreSQL、MySQL、MongoDB、Redis、Elasticsearch
- 其他：Docker/Kubernetes、AWS/Azure/GCP
输出: 匹配的模板列表和推荐模板
参考：references/templates-guide.md 查看所有可用模板
阶段 2：角色定制
基于模板推荐角色，允许用户调整。
步骤 1: 展示推荐角色（按类别分组）
- 🏗️ 架构与设计
- 💻 开发团队
- 🧪 质量保障
- 🚀 运维与支持
问题 1: 是否接受推荐？（接受全部/我要调整/从零开始）
问题 2: 添加额外角色（多选）
- 📊 数据与分析：Data Analyst、Data Engineer、ML Engineer、BI Developer
- 📱 移动与客户端：iOS/Android Developer、Mobile Architect、Flutter Developer
- 🎨 设计与产品：UI/UX Designer、Product Manager、Product Designer
- 📝 文档与支持：Technical Writer、API Documentation Specialist
- 🔧 专项工程师：Infrastructure Engineer、Cloud Architect、Security Engineer
- 🤖 AI/ML 专项：NLP Engineer、Computer Vision Engineer、MLOps Engineer、Prompt Engineer
问题 3: 哪些角色由人类主导？（多选）
问题 4: AI Agent 模型策略（单选）
- 智能分配（推荐）- 复杂任务用 Opus，常规任务用 Sonnet
- 全部使用 Sonnet 4.5
- 全部使用 Opus 4.6
- 全部使用 Haiku 4.5
输出: 完整的角色列表配置
参考：references/role-library.md 查看所有可用角色详情
阶段 3：工作流构建
配置团队工作流程。
步骤 1: 展示推荐工作流
- 📋 标准功能开发流程
- 🤖 AI 功能开发流程
- 🗄️ 数据库优化流程
问题 1: 是否接受推荐？（接受全部/我要调整/添加自定义）
问题 2: 添加自定义工作流（多选）
- 紧急 Bug 修复流程
- 代码重构流程
- 安全漏洞修复流程
- 性能优化流程
- 数据迁移流程
- API 版本升级流程
问题 3: 并行执行策略（单选）
- 最大化并行（推荐）
- 部分并行
- 完全串行
输出: 工作流配置
参考：references/workflow-patterns.md 查看工作流模式库
阶段 4：组件配置（可选）
配置高级组件。
问题 1: 配置层级（单选）
- 仅核心配置（推荐）
- 第二层：推荐组件
- 第三层：完整配置
- 全部配置
问题 2: Skill 配置（多选）
- 已推荐：backend-patterns、frontend-patterns、python-patterns、tdd-workflow
- 额外可选：api-security、devops-automation、django-patterns、springboot-patterns、mongodb-patterns、frontend-design、ui-ux-pro-max
问题 3: Hook 配置（多选）
- PreToolUse：Git Push 审查、文档拦截器、长时间命令提醒
- PostToolUse：自动格式化、TypeScript 检查、Console.log 警告
- Stop：Console.log 审计、未提交代码提醒、测试运行提醒
问题 4: 协作规则（多选）
- 强制代码审查
- 最小审查人数（至少 2 人）
- 强制测试覆盖率（至少 80%）
- 强制安全审查
- 生产环境部署审批
输出: 组件配置
参考：references/components-guide.md 查看组件配置详情
阶段 5：智能推荐（可选）
分析配置并提供优化建议。
分析内容:
- 角色优化建议（检测职责重叠、缺失关键角色）
- 技能补充建议（根据角色和项目类型推荐）
- 工作流优化建议（根据项目类型推荐流程）
- 协作规则建议（根据团队规模和项目类型）
问题: 是否应用推荐？（全部应用/选择性应用/跳过）
输出: 应用推荐后的最终配置
参考：references/best-practices.md 查看最佳实践指南
阶段 6：输出生成
生成配置文件和文档。
问题 1: 输出文件选择（多选）
- 核心配置：team-config.yaml（必选）
- 文档：TEAMS.md、README.md、WORKFLOWS.md
- 角色文档：所有角色/仅核心角色/不生成
- 组件配置：.claude/skills/、.claude/hooks/、.claude/rules/
问题 2: 文件命名
- 输入项目名称或自定义文件名
问题 3: 输出位置（单选）
- docs/teams/（推荐）
- .claude/teams/
- project-root/
- 自定义路径
问题 4: 生成后操作（多选）
- 在编辑器中打开配置文件
- 显示配置文件内容（可复制）
- 生成使用说明文档
- 验证配置文件格式
- 提交到 Git
输出: 生成的文件列表和路径
YAML 配置生成
在阶段 6 完成后，根据用户的配置选择生成完整的 YAML 配置文件。
生成策略
策略 1: 基于模板生成（推荐）
如果用户选择了模板：
- 读取对应的模板文件（
assets/templates/by-type/*.yaml） - 根据用户的定制修改模板内容
- 应用用户选择的角色、工作流、组件配置
- 生成最终的 YAML 文件
策略 2: 从零生成
如果用户从零开始：
- 使用
references/data-structures.md中定义的数据结构 - 根据用户选择逐步构建配置对象
- 按照标准格式生成 YAML 文件
生成步骤
步骤 1: 构建配置对象
根据用户在 6 个阶段中的选择，构建完整的配置对象：
team:
name: [用户输入的团队名称]
description: [根据项目类型生成的描述]
version: "1.0"
roles:
# 从阶段 2 的角色选择生成
- name: [角色名称]
code: [角色代码]
type: [human-led 或 agent]
model: [如果是 agent，根据阶段 2 的模型策略选择]
description: [角色描述]
skills: [从阶段 4 的 Skill 配置生成]
responsibilities: [角色职责列表]
workflows:
# 从阶段 3 的工作流选择生成
- name: [工作流名称]
description: [工作流描述]
steps:
- role: [角色代码]
action: [操作类型]
description: [步骤描述]
parallel: [根据阶段 3 的并行策略设置]
collaboration:
# 从阶段 4 的协作规则生成
code_review:
required: [true/false]
reviewers: [审查者角色列表]
min_approvals: [最小审查人数]
testing:
required: [true/false]
coverage_threshold: [覆盖率阈值]
types: [测试类型列表]
deployment:
environments: [环境列表]
approval_required:
staging: [true/false]
production: [true/false]
project:
# 从阶段 1 的技术栈选择生成
tech_stack:
backend: [后端技术栈列表]
frontend: [前端技术栈列表]
databases: [数据库列表]
cloud: [云服务列表]
步骤 2: 生成 YAML 文件
使用 Write 工具将配置对象写入文件：
# 伪代码示例
config = build_config_from_user_choices()
yaml_content = format_as_yaml(config)
write_file(output_path, yaml_content)
步骤 3: 添加注释和元数据
在生成的 YAML 文件顶部添加：
- 文件描述注释
- 生成日期
- 配置版本
- 使用说明链接
示例：
# Claude Code Teams Configuration
# 生成日期: 2026-02-12
# 项目类型: AI/ML Platform
# 团队规模: Medium (6-15 people)
#
# 使用说明: 将此文件放置在 docs/teams/ 目录下
# 详细文档: https://docs.anthropic.com/claude-code/teams
team:
name: AI Platform Team
...
模板引用
生成时可以参考以下模板文件：
assets/templates/by-type/ai-ml-platform.yaml- AI/ML 平台模板assets/templates/by-type/web-fullstack.yaml- Web 全栈应用模板assets/templates/by-type/backend-only.yaml- 纯后端项目模板assets/templates/by-type/frontend-only.yaml- 纯前端项目模板assets/templates/by-type/microservices.yaml- 微服务架构模板
生成示例
示例 1: 基于 AI 平台模板生成
用户选择：
- 项目类型：AI/ML 平台
- 团队规模：中型团队
- 技术栈：Python + FastAPI + React
- 角色：接受推荐 + 添加 Data Engineer
- 工作流：接受推荐
- 模型策略：智能分配
生成过程：
- 读取
assets/templates/by-type/ai-ml-platform.yaml - 添加 Data Engineer 角色到 roles 列表
- 根据智能分配策略设置每个角色的 model 字段
- 保持推荐的工作流不变
- 生成到
docs/teams/ai-platform-team.yaml
示例 2: 从零生成微服务团队
用户选择：
- 从零开始
- 添加角色：Architect, Service Developer, API Gateway Engineer, DevOps Engineer, QA Engineer
- 自定义工作流：Service Development, Service Integration
- 并行策略：最大化并行
- 协作规则：强制代码审查 + 测试覆盖率 80%
生成过程：
- 创建空的配置对象
- 添加用户选择的 5 个角色
- 为每个角色分配合适的 skills（从 role-library.md 查询）
- 构建 2 个自定义工作流
- 设置工作流步骤的 parallel 字段为 true（最大化并行）
- 添加协作规则配置
- 生成到用户指定的路径
验证生成的文件
生成后立即验证：
- YAML 语法正确性
- 必填字段完整性
- 引用的角色、技能、模型是否有效
- 工作流步骤引用的角色是否存在
如果验证失败，提供清晰的错误信息和修复建议。
配置验证
生成配置后，自动执行验证：
阶段 1: 语法验证
- YAML 格式正确
- 必填字段完整
- 数据类型正确
阶段 2: 语义验证
- 角色代码唯一
- 工作流引用的角色存在
- 技能名称有效
- 模型名称有效
阶段 3: 最佳实践检查
- 团队规模与角色数量匹配
- 工作流覆盖主要场景
- 关键角色已配置
- 安全审查已启用
阶段 4: 生成验证报告
- 显示通过/警告/错误统计
- 提供优化建议
错误处理
友好的错误提示:
❌ 错误：角色代码重复
问题：检测到重复的角色代码 "backend-dev"
建议：使用不同的代码，如 "backend-dev-api" 和 "backend-dev-service"
⚠️ 警告：技能不存在
问题：技能 "custom-skill" 在 Claude Code 中不存在
建议：创建自定义技能或使用相似技能
💡 提示：优化建议
问题：小型团队配置了 12 个角色
建议：考虑合并相似角色或使用中型团队模板
资源文件
references/
详细的参考文档，按需加载：
templates-guide.md- 所有模板的详细说明role-library.md- 50+ 角色的完整定义workflow-patterns.md- 工作流模式库components-guide.md- Skill、Hook、Rule 配置指南best-practices.md- 团队配置最佳实践data-structures.md- 配置文件数据结构定义
assets/
模板文件和示例：
templates/- YAML 模板文件by-type/- 按项目类型分类by-scale/- 按团队规模分类by-stack/- 按技术栈分类
examples/- 完整的示例配置prompthub-example/- AI 平台示例simple-web-example/- 简单 Web 项目示例microservices-example/- 微服务架构示例
使用示例
示例 1: 快速创建 AI 平台团队
用户：帮我创建一个 AI 平台的团队配置
Claude：
1. 项目类型选择：AI/ML 平台 + 后端项目
2. 团队规模：中型团队（6-15人）
3. 技术栈：Python FastAPI + React + PostgreSQL
4. 推荐角色：Architect, Backend Dev, AI Engineer, Frontend Dev, QA, Security Reviewer...
5. 用户确认并微调
6. 生成配置文件到 docs/teams/ai-platform.yaml
示例 2: 从零开始定制
用户：我要创建一个完全自定义的团队
Claude：
1. 跳过模板选择，从零开始
2. 用户逐个添加需要的角色
3. 自定义工作流程
4. 配置高级组件
5. 应用智能推荐
6. 生成完整配置套件
Markdown 文档生成器
在阶段 6 中，如果用户选择生成 Markdown 文档，使用以下生成器创建团队文档。
TEAMS.md 生成器
生成团队概览文档，包含团队结构、角色说明和协作规则。
生成内容:
# [Team Name] - 团队配置
**生成日期**: 2026-02-12
**版本**: 1.0
## 团队概览
[团队描述]
**团队规模**: [规模]
**项目类型**: [类型]
**技术栈**: [技术栈列表]
## 团队角色
### 架构与设计
#### [角色名称]
- **代码**: `role-code`
- **类型**: human-led / agent (model)
- **职责**:
- 职责 1
- 职责 2
- **技能**: skill1, skill2
[重复其他角色...]
## 协作规则
### 代码审查
- **必需**: 是/否
- **审查者**: [角色列表]
- **最小审批数**: N
### 测试要求
- **必需**: 是/否
- **覆盖率阈值**: N%
- **测试类型**: unit, integration, e2e
### 部署流程
- **环境**: development, staging, production
- **审批要求**:
- staging: 是/否
- production: 是/否
## 使用说明
1. 将 `team-config.yaml` 放置在 `docs/teams/` 目录
2. Claude Code 会自动加载团队配置
3. 使用 `/team` 命令查看团队状态
4. 使用 `/workflow` 命令触发工作流
## 相关文档
- [工作流文档](./WORKFLOWS.md)
- [角色详细定义](./roles/)
- [最佳实践](../../references/best-practices.md)
生成步骤:
- 读取生成的 YAML 配置文件
- 提取团队信息、角色列表、协作规则
- 按照模板格式化为 Markdown
- 写入
TEAMS.md文件
WORKFLOWS.md 生成器
生成工作流详细文档，包含每个工作流的步骤和说明。
生成内容:
# 工作流文档
本文档描述 [Team Name] 的所有工作流程。
## 工作流列表
1. [工作流 1 名称](#workflow-1)
2. [工作流 2 名称](#workflow-2)
---
## [工作流 1 名称]
**描述**: [工作流描述]
**适用场景**: [使用场景说明]
### 工作流步骤
#### 步骤 1: [步骤描述]
- **负责角色**: [角色名称] (`role-code`)
- **操作**: [action]
- **并行执行**: 是/否
#### 步骤 2: [步骤描述]
- **负责角色**: [角色名称] (`role-code`)
- **操作**: [action]
- **并行执行**: 是/否
[重复其他步骤...]
### 工作流图
```mermaid
graph TD
A[步骤 1] --> B[步骤 2]
B --> C[步骤 3]
C --> D[步骤 4]
注意事项
- 注意事项 1
- 注意事项 2
[重复其他工作流...]
工作流最佳实践
- 始终遵循工作流顺序
- 并行步骤可以同时执行
- 关键步骤需要审批
- 记录工作流执行结果
**生成步骤**:
1. 读取生成的 YAML 配置文件
2. 提取所有工作流定义
3. 为每个工作流生成详细文档
4. 可选：生成 Mermaid 流程图
5. 写入 `WORKFLOWS.md` 文件
### README.md 生成器
生成项目级别的 README 文档，包含快速开始指南。
**生成内容**:
```markdown
# [Project Name] - Claude Code Teams
本项目使用 Claude Code Teams 进行团队协作开发。
## 快速开始
### 1. 安装 Claude Code
```bash
npm install -g @anthropic/claude-code
2. 配置团队
团队配置文件位于 docs/teams/team-config.yaml。
3. 启动开发
claude-code
团队结构
- 团队规模: [规模]
- 角色数量: [数量]
- 工作流数量: [数量]
查看完整团队配置：TEAMS.md
工作流
本项目包含以下工作流：
- [工作流 1] - [简短描述]
- [工作流 2] - [简短描述]
查看完整工作流文档：WORKFLOWS.md
技术栈
后端
- [技术 1]
- [技术 2]
前端
- [技术 1]
- [技术 2]
数据库
- [数据库 1]
- [数据库 2]
开发规范
- 代码审查：[审查要求]
- 测试覆盖率：[覆盖率要求]
- 部署流程：[部署说明]
相关文档
**生成步骤**:
1. 读取生成的 YAML 配置文件
2. 提取项目信息和技术栈
3. 生成快速开始指南
4. 写入 `README.md` 文件
## 角色文档生成器
为每个角色生成详细的文档文件，包含职责、技能、工作流参与等信息。
### 单个角色文档生成
**文件路径**: `docs/teams/roles/[role-code].md`
**生成内容**:
```markdown
# [角色名称]
**代码**: `role-code`
**类型**: human-led / agent
**模型**: claude-opus-4.6 / claude-sonnet-4.5 (如果是 agent)
## 角色描述
[角色详细描述]
## 职责范围
1. **[职责类别 1]**
- 职责 1
- 职责 2
2. **[职责类别 2]**
- 职责 1
- 职责 2
## 技能要求
### 必需技能
- **[技能 1]**: [技能描述]
- **[技能 2]**: [技能描述]
### 推荐技能
- **[技能 3]**: [技能描述]
## 参与的工作流
### [工作流 1 名称]
- **步骤**: [步骤描述]
- **操作**: [action]
- **并行执行**: 是/否
### [工作流 2 名称]
- **步骤**: [步骤描述]
- **操作**: [action]
- **并行执行**: 是/否
## 协作关系
### 上游角色
- **[角色名称]**: [协作说明]
### 下游角色
- **[角色名称]**: [协作说明]
### 审查关系
- **审查者**: [角色列表]
- **被审查者**: [角色列表]
## 工作指南
### 日常工作流程
1. [步骤 1]
2. [步骤 2]
3. [步骤 3]
### 最佳实践
- 最佳实践 1
- 最佳实践 2
### 常见问题
- **问题 1**: [解答]
- **问题 2**: [解答]
## 相关资源
- [技能文档](../../../.claude/skills/)
- [工作流文档](../WORKFLOWS.md)
- [团队配置](../TEAMS.md)
生成步骤:
- 读取生成的 YAML 配置文件
- 提取单个角色的完整信息
- 从
references/role-library.md获取角色详细描述 - 分析角色在工作流中的参与情况
- 生成协作关系图
- 写入
docs/teams/roles/[role-code].md文件
角色索引文档生成
文件路径: docs/teams/roles/README.md
生成内容:
# 角色索引
本文档列出 [Team Name] 的所有角色。
## 角色分类
### 架构与设计 (N 个角色)
- **[角色名称]** (`role-code`) - [简短描述] - [详细文档](./role-code.md)
### 开发团队 (N 个角色)
- **[角色名称]** (`role-code`) - [简短描述] - [详细文档](./role-code.md)
### 质量保障 (N 个角色)
- **[角色名称]** (`role-code`) - [简短描述] - [详细文档](./role-code.md)
### 运维与支持 (N 个角色)
- **[角色名称]** (`role-code`) - [简短描述] - [详细文档](./role-code.md)
## 角色类型统计
- **人类主导**: N 个
- **AI Agent (Opus 4.6)**: N 个
- **AI Agent (Sonnet 4.5)**: N 个
- **AI Agent (Haiku 4.5)**: N 个
## 技能分布
- **backend-patterns**: [角色列表]
- **frontend-patterns**: [角色列表]
- **python-patterns**: [角色列表]
- [其他技能...]
## 工作流参与度
| 角色 | 参与工作流数 | 主要工作流 |
|------|-------------|-----------|
| [角色名称] | N | [工作流列表] |
## 相关文档
- [团队配置](../TEAMS.md)
- [工作流文档](../WORKFLOWS.md)
生成步骤:
- 读取生成的 YAML 配置文件
- 提取所有角色信息
- 按类别分组角色
- 统计角色类型和技能分布
- 分析工作流参与度
- 写入
docs/teams/roles/README.md文件
批量生成角色文档
生成逻辑:
# 伪代码示例
def generate_all_role_docs(config):
roles = config['team']['roles']
# 创建 roles 目录
create_directory('docs/teams/roles/')
# 生成每个角色的文档
for role in roles:
role_doc = generate_role_doc(role, config)
write_file(f'docs/teams/roles/{role["code"]}.md', role_doc)
# 生成角色索引
index_doc = generate_role_index(roles, config)
write_file('docs/teams/roles/README.md', index_doc)
生成器使用示例
示例 1: 生成完整文档套件
用户在阶段 6 选择：
- ✅ team-config.yaml
- ✅ TEAMS.md
- ✅ WORKFLOWS.md
- ✅ README.md
- ✅ 所有角色文档
生成结果：
docs/teams/
├── team-config.yaml # YAML 配置文件
├── README.md # 项目 README
├── TEAMS.md # 团队概览文档
├── WORKFLOWS.md # 工作流文档
└── roles/ # 角色文档目录
├── README.md # 角色索引
├── architect.md # 架构师文档
├── backend-dev.md # 后端开发者文档
├── frontend-dev.md # 前端开发者文档
└── ... # 其他角色文档
示例 2: 仅生成核心文档
用户在阶段 6 选择：
- ✅ team-config.yaml
- ✅ TEAMS.md
- ❌ WORKFLOWS.md
- ❌ README.md
- ✅ 仅核心角色文档
生成结果：
docs/teams/
├── team-config.yaml
├── TEAMS.md
└── roles/
├── README.md
├── architect.md
├── backend-dev.md
└── frontend-dev.md
版本: 1.0.0 创建日期: 2026-02-12 维护者: Team Creator