# Team Init

> This skill should be used when the user asks to "初始化团队", "创建开发团队", "team init", "create team", "build team", "组建团队", "启动项目团队", "添加扩展角色", "add extension roles". 通过交互式问答收集项目信息， 创建包含专业角色的 Agent 工程团队。支持 8 种团队类型和 153 个扩展专业角色（跨 12 领域）。

- Skill: `killvxk/team-init` (Agent Skill, multi-file: 218 files)
- Install (CLI): `npx skillmds@latest add killvxk/team-init`
- Raw SKILL.md: https://api.skillmd.com/api/skills/killvxk/team-init/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: killvxk (https://skillmd.com/u/killvxk)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/killvxk/team-init

---


# 工程团队初始化

通过交互式问答，收集项目信息并创建由 Lead 领导的 Agent 工程团队。

## 路径约定

本 skill 中 `references/` 和 `scripts/` 路径均相对于 SKILL.md 所在目录（skill base directory）。执行时以 base directory 拼接绝对路径。**不要硬编码 `~/.claude/skills/`** — skill 可能安装在项目级 `.claude/skills/` 或全局 `~/.claude/skills/` 下。

## 支持的团队类型

| # | 类型 | 领导角色 | 目录 | 适用场景 |
|---|------|---------|------|---------|
| 1 | 软件开发 | PM | dev | 全新项目开发、功能迭代 |
| 2 | 软件测试 | 测试经理 | testing | 系统测试、质量保障 |
| 3 | 逆向工程 | 逆向负责人 | reverse | 二进制分析、协议逆向、恶意软件分析 |
| 4 | 调试/Bug修复 | 调试负责人 | debug | 故障排查、性能问题定位 |
| 5 | 安全研究 | 安全负责人 | security | 漏洞挖掘、安全评估(需合法授权) |
| 6 | CTF 比赛 | 队长 | ctf | CTF 竞赛、安全挑战 |
| 7 | 运维 | 运维经理 | ops | 部署运维、基础设施管理 |
| 8 | 讨论/研讨 | 主持人 | discuss | 方案设计、技术选型、需求研讨、头脑风暴 |

各类型的详细角色列表见 `references/role-catalog.md`。

## 交互式问答流程

按顺序使用 AskUserQuestion 工具向用户提问。

### 问题 0: 团队类型

```
AskUserQuestion:
  question: "请选择要创建的团队类型"
  header: "团队类型"
  options:
    - label: "软件开发"
      description: "全新项目开发、功能迭代"
    - label: "软件测试"
      description: "系统测试、质量保障"
    - label: "逆向工程"
      description: "二进制分析、协议逆向"
    - label: "调试/Bug修复"
      description: "故障排查、性能定位"
    - label: "安全研究"
      description: "漏洞挖掘、安全评估(需合法授权)"
    - label: "CTF 比赛"
      description: "CTF 竞赛、安全挑战"
    - label: "运维"
      description: "部署运维、基础设施管理"
    - label: "讨论/研讨"
      description: "方案设计、技术选型、需求研讨、头脑风暴"
  multiSelect: false
```

记录用户选择的 `team_type`，映射到对应目录名：
- 软件开发 → dev
- 软件测试 → testing
- 逆向工程 → reverse
- 调试/Bug修复 → debug
- 安全研究 → security
- CTF 比赛 → ctf
- 运维 → ops
- 讨论/研讨 → discuss

### 问题 1: 项目名称

如果 `$ARGUMENTS` 非空，使用其作为项目名称，跳过此问题。

```
AskUserQuestion:
  question: "请输入项目名称（英文，用作 team name，如 my-webapp）"
  header: "项目名称"
  options:
    - label: "my-project"
      description: "使用默认名称"
    - label: "输入自定义名称"
      description: "在「其他」中输入"
  multiSelect: false
```

### 问题 2: 项目描述

```
AskUserQuestion:
  question: "{根据 team_type 调整措辞}"
  header: "项目描述"
  options: {根据 team_type 提供 2-4 个典型场景选项}
  multiSelect: false
```

措辞映射：
- dev: "请简要描述项目目标和范围"
- testing: "请描述被测系统和测试目标"
- reverse: "请描述逆向目标和分析目的"
- debug: "请描述需要调试的问题和症状"
- security: "请描述安全研究的目标和范围"
- ctf: "请描述比赛名称和赛制"
- ops: "请描述运维目标和基础设施概况"
- discuss: "请描述讨论议题和期望产出"

### 问题 3: 技术栈/目标平台

```
AskUserQuestion:
  question: "{根据 team_type 调整措辞}"
  header: "技术栈"
  options: {根据 team_type 提供 2-4 个典型选项}
  multiSelect: true
```

措辞映射：
- dev: "项目使用什么技术栈？"
- testing: "被测系统的技术栈？"
- reverse: "目标平台和架构？（x86/ARM/MIPS, Windows/Linux/Android）"
- debug: "问题所在的技术栈和环境？"
- security: "研究目标的技术栈和平台？"
- ctf: "比赛偏好方向和工具？"
- ops: "基础设施技术栈？（Linux/K8s/AWS/Docker）"
- discuss: "讨论涉及哪些领域？（用于配置专家角色的专业背景）"

### 问题 4: 角色选择

展示当前 team_type 的角色列表。Lead 角色自动包含，无需选择。

```
AskUserQuestion:
  question: "选择需要的角色（{lead_role} 默认包含）。多实例角色可在「其他」中用 'developer x2' 格式指定数量"
  header: "团队角色"
  options:
    - label: "全部角色 (推荐)"
      description: "包含该类型所有角色各 1 个"
    - label: "核心团队"
      description: "{该类型的核心角色子集}"
    - label: "最小团队"
      description: "{lead + 1-2 个核心角色}"
    - label: "自定义"
      description: "在「其他」中指定角色和数量"
  multiSelect: false
```

核心团队映射：
- dev: pm + architect + developer + tester
- testing: test-manager + test-architect + functional-tester + automation-tester
- reverse: re-lead + static-analyst + dynamic-analyst
- debug: debug-lead + root-cause-analyst + fix-engineer
- security: security-lead + vuln-hunter + security-auditor
- ctf: captain + web + pwn + reverse
- ops: ops-manager + sys-engineer + monitor-engineer
- discuss: moderator + domain-expert + critic + synthesizer

最小团队映射：
- dev: pm + developer
- testing: test-manager + functional-tester
- reverse: re-lead + static-analyst
- debug: debug-lead + fix-engineer
- security: security-lead + vuln-hunter
- ctf: captain + web
- ops: ops-manager + sys-engineer
- discuss: moderator + domain-expert

### 问题 4.2: 扩展角色（可选）

```
AskUserQuestion:
  question: "是否从扩展角色库添加专业角色？（153 个跨 12 领域的专家角色）"
  header: "扩展角色"
  options:
    - label: "跳过"
      description: "仅使用核心团队角色"
    - label: "浏览并选择"
      description: "从扩展角色库中挑选专业角色"
  multiSelect: false
```

若选择「跳过」→ 若 team_type 为 discuss 则进入问题 4.6（讨论轮次）；否则进入问题 5（确认）。
若选择「浏览并选择」→ 进入问题 4.3。

### 问题 4.3: 选择扩展领域

读取 `references/extensions/extension-catalog.md` 获取完整领域列表。

```
AskUserQuestion:
  question: "选择要浏览的领域（可多选）"
  header: "扩展角色领域"
  options:
    - label: "engineering"
      description: "22个: 前端、后端、AI、DevOps、安全、嵌入式..."
    - label: "design"
      description: "8个: UI、UX、品牌、视觉叙事..."
    - label: "marketing"
      description: "29个: 小红书、抖音、微信、B站、SEO..."
    - label: "game-development"
      description: "19个: Unity、Unreal、Godot、Roblox..."
    - label: "paid-media"
      description: "7个: PPC、社交广告、程序化采买..."
    - label: "product"
      description: "11个: 产品发现、战略、执行、市场研究、数据分析、GTM、营销增长..."
    - label: "project-management"
      description: "6个: 制片人、项目协调、实验追踪..."
    - label: "sales"
      description: "8个: 赢单策略、售前工程、Pipeline分析..."
    - label: "support"
      description: "8个: 数据分析、法务合规、财务、招聘..."
    - label: "spatial-computing"
      description: "6个: visionOS、WebXR、Metal..."
    - label: "specialized"
      description: "21个: 编排、区块链安全、MCP、合规..."
    - label: "testing"
      description: "8个: 证据收集、无障碍、API测试..."
  multiSelect: true
```

### 问题 4.4: 选择具体角色

对用户选中的每个领域，从 `references/extensions/extension-catalog.md` 读取该领域的角色列表，展示给用户选择：

```
AskUserQuestion:
  question: "选择要添加的 {department} 角色"
  header: "{department} 扩展角色"
  options:
    {从 extension-catalog.md 读取对应领域角色列表，每个角色一个选项}
  multiSelect: true
```

对每个选中领域重复此问题。记录所有选中的扩展角色 `ext_roles[]`，每项包含 `department` 和 `role_code`。

完成所有领域的角色选择后：若 team_type 为 discuss → 进入问题 4.6（讨论轮次）；否则 → 进入问题 4.5（远程角色）。

### 问题 4.5 — 远程角色追加（可选）

**前置条件**：检测 `{work_dir}/.team-roles/roles-lock.json` 是否存在且 `roles` 数组非空。若不存在或为空 → 跳过此步骤，直接进入问题 4.6（discuss 类型）或问题 5（工作目录）。

若存在，使用 `AskUserQuestion` 提问：

```
AskUserQuestion:
  question: "是否从已安装的远程角色中添加团队成员？"
  header: "远程角色"
  options:
    - label: "跳过"
      description: "不添加远程角色"
    - label: "浏览已安装的远程角色"
      description: "从已安装的远程角色中选择要加入团队的成员"
    - label: "现在安装新的远程角色"
      description: "输入 GitHub repo URL 或 npx 包名，安装后选择"
  multiSelect: false
```

**选项处理**：

- **跳过** → 若 team_type 为 discuss 则进入问题 4.6（讨论轮次）；否则进入问题 5（工作目录）。
- **浏览已安装** → 读取 `{work_dir}/.team-roles/roles-lock.json`，以表格展示所有角色（代号、来源、verified/unverified 状态、简述），使用 `AskUserQuestion` 让用户多选要加入的角色。选定后追加到 `selected_extension_roles` 列表，标记 `source: remote`。
- **现在安装新的** → 提示用户输入 repo URL 或 npx 包名，按 `/team-roles add` 的完整流程执行（参考 `../team-roles/SKILL.md` 的 add 指令）。安装完成后回到本问题重新列出可选角色。

**远程角色选择展示格式**：

```
| 代号              | 来源              | 状态         | 简述           |
|-------------------|-------------------|-------------|----------------|
| ai-engineer       | user/my-roles     | ✓ verified  | AI 工程师...    |
| vite-skill        | antfu/skills@vite | ⚠ unverified | Vite 开发...   |
| custom-reviewer   | (单文件)           | ✓ verified  | 代码审查...     |
```

### 问题 4.6: 讨论轮次（仅 discuss 类型触发）

```
AskUserQuestion:
  question: "每个议题的最大讨论轮次？"
  header: "讨论轮次"
  options:
    - label: "3 轮（默认）"
    - label: "5 轮"
    - label: "自定义"
  multiSelect: false
```

`max_rounds` 写入配置和 prompt 的 `<project_context>` 中。

### 问题 5: 工作目录

```
AskUserQuestion:
  question: "项目工作目录在哪里？"
  header: "工作目录"
  options:
    - label: "当前目录"
      description: "使用当前工作目录"
    - label: "指定路径"
      description: "在「其他」中输入绝对路径"
  multiSelect: false
```

### 确认步骤

输出汇总信息，然后确认：

```
团队配置汇总
--------------------
团队类型: {team_type_name}
项目名称: {project_name}
项目描述: {description}
技术栈:   {tech_stack}
工作目录: {work_dir}

团队成员:
  - {lead_role} x1 (Lead)
  - {role_name} x{count}
  ...
{若有扩展角色}
扩展角色:
  - {ext_role_name} ({department})
  ...
{若有远程角色}
远程角色:
  - {role_code} ({source}) [verified/unverified]
  ...

预计创建 {N} 个 Agent
--------------------
```

若本次团队包含 unverified 远程角色，在确认步骤汇总信息后额外输出警告：

```
⚠ 本次团队包含 {N} 个未验证远程角色：{role1}, {role2}
   未验证角色的内容未经 5-Block 格式校验，请确认已审阅其内容。
```

```
AskUserQuestion:
  question: "确认以上配置并创建团队？"
  header: "确认"
  options:
    - label: "确认创建"
      description: "开始创建团队"
    - label: "修改配置"
      description: "重新开始问答"
    - label: "取消"
      description: "放弃创建"
  multiSelect: false
```

## 团队创建流程

用户确认后，执行以下步骤。

### 步骤 1: 准备角色定义（写入 .teams/）

将角色定义文件复制到项目工作目录的 `.teams/{project_name}/`，供用户在团队启动前审阅和修改。

**来源路径**（相对于 skill base directory）:
- 角色定义: `references/{type_dir}/roles/{role_code}.md`
- 工作流: `references/{type_dir}/workflow.md`

使用 Read 工具时，将以上相对路径拼接到 skill base directory 构建绝对路径。

**写入目标**:

```
{work_dir}/.teams/{project_name}/
├── team.yaml           # 团队配置摘要
├── workflow.md          # 工作流定义（从 references 复制）
└── roles/
    ├── {lead_role}.md   # Lead 角色定义
    ├── {role_1}.md      # 执行角色定义
    └── ...
```

**操作步骤**:

1. 使用 Bash 创建目录: `mkdir -p "{work_dir}/.teams/{project_name}/roles"`
2. 使用 Read 读取每个核心角色定义文件和 workflow.md
3. 使用 Write 将每个核心角色定义写入 `.teams/{project_name}/roles/{role_code}.md`
4. 若有扩展角色（`ext_roles[]` 非空）:
   - 扩展角色来源路径: `references/extensions/{department}/{role_code}.md`
   - 使用 Read 读取每个扩展角色定义
   - 使用 Write 写入 `.teams/{project_name}/roles/ext-{department}-{role_code}.md`（加 `ext-` 前缀）
5. 若有远程角色（`selected_extension_roles` 中含 `source: remote` 条目）:
   - 读取 `{work_dir}/.team-roles/roles-lock.json`，查找每个远程角色的 `filePath`
   - 使用 Read 读取 `{work_dir}/.team-roles/{filePath}` 获取角色内容
   - 使用 Write 写入 `.teams/{project_name}/roles/{role_code}.md`（直接用角色代号，不加前缀）
6. 使用 Write 将 workflow.md 写入 `.teams/{project_name}/workflow.md`
7. 使用 Write 创建 `.teams/{project_name}/team.yaml`:

```yaml
# 团队配置 - 由 /team-init 准备
# 修改 roles/ 下的 .md 文件可自定义角色行为
# 确认后使用「开始创建」启动团队

team_type: "{type_dir}"
team_type_name: "{team_type_name}"
project_name: "{project_name}"
description: "{description}"
tech_stack: "{tech_stack}"
work_dir: "{work_dir}"

roles:
  - role: "{lead_role_code}"
    count: 1
    is_lead: true
  - role: "{role_code}"
    count: {N}
  # ... 核心角色

  # 扩展角色（如有）
  # - role: "ext-{department}-{role_code}"
  #   count: 1
  #   source: extension
  #   department: "{department}"

  # 远程角色（如有）
  # - role: "{role_code}"
  #   count: 1
  #   source: remote
  #   remote_source: "{source_from_lock}"
  #   verified: true/false
```

### 步骤 2: 用户审阅角色定义

输出角色文件路径并提示用户审阅：

```
角色定义已准备就绪
--------------------
目录: {work_dir}/.teams/{project_name}/

文件列表:
  workflow.md          — 工作流定义
  roles/{lead_role}.md — {lead_role_name}（Lead）
  roles/{role_1}.md    — {role_1_name}
  roles/{role_2}.md    — {role_2_name}
  ...

您可以在编辑器中打开并修改这些文件，自定义角色行为。
修改完成后选择「开始创建」启动团队。
--------------------
```

```
AskUserQuestion:
  question: "准备好启动团队了吗？"
  header: "审阅角色定义"
  options:
    - label: "开始创建"
      description: "使用当前角色定义（含您的修改）创建团队"
    - label: "打开目录"
      description: "显示文件完整路径，方便在编辑器中打开"
    - label: "取消"
      description: "放弃创建，保留 .teams/ 目录供后续使用"
  multiSelect: false
```

如果用户选择「打开目录」，输出每个文件的完整绝对路径，然后再次询问是否开始创建。
如果用户选择「取消」，输出提示后结束：

```
团队创建已取消。角色定义保留在:
  {work_dir}/.teams/{project_name}/

后续可手动编辑后，使用 /team-init {project_name} 重新启动
（检测到 .teams/ 目录时将直接使用其中的角色定义）。
```

### 步骤 3: 创建团队（TeamCreate 工具）

> **⚠ 关键步骤 — 不可跳过。** 必须使用 `TeamCreate` 工具注册团队。此步骤创建团队配置和共享 TaskList，是步骤 7 中 `Agent(team_name=...)` 生效的前提。若跳过此步骤直接调用 Agent，成员将成为独立 subagent 而非团队成员 — 无法共享 TaskList、无法通过 SendMessage 互相通信。

```
TeamCreate:
  team_name: "{project_name}"
  description: "{team_type_name} - {description}"
```

### 步骤 4: 读取角色定义和工作流

**从 `.teams/` 目录读取**（而非直接从 references/ 读取），这样包含了用户的修改。

角色定义路径: `{work_dir}/.teams/{project_name}/roles/{role_code}.md`
工作流路径: `{work_dir}/.teams/{project_name}/workflow.md`

对每个选中的角色，使用 Read 工具读取其角色定义文件。
同时读取 workflow.md。

### 步骤 5: 构建角色 Prompt

为每个成员组合 prompt。**Lead 角色与执行角色使用不同的工作流注入策略**，以控制 prompt 长度。

> **重要**: 角色定义从 `.teams/{project_name}/roles/` 读取（步骤 4），包含用户可能做的修改。

#### Lead 角色的 Prompt

Lead 角色负责管理整个工作流，因此注入**完整的 workflow.md 内容**。

```
你是「{project_name}」项目的{role_name}。

<project_context>
项目名称: {project_name}
团队类型: {team_type_name}
项目描述: {description}
技术栈: {tech_stack}
工作目录: {work_dir}
{若 discuss 类型} 最大讨论轮次: {max_rounds}
</project_context>

<team_members>
{列出所有成员的名称和角色}
</team_members>

<workflow>
{workflow.md 的完整内容}
</workflow>

<your_role>
{对应角色 .md 文件的完整内容}
</your_role>
```

#### 执行角色的 Prompt

执行角色无需完整工作流，仅注入 workflow.md 中的**阶段总览表格**（即 `## 阶段总览` 下的 Markdown 表格，通常 5-10 行），不包含各阶段的详细流程描述。

```
你是「{project_name}」项目的{role_name}。

<project_context>
项目名称: {project_name}
团队类型: {team_type_name}
项目描述: {description}
技术栈: {tech_stack}
工作目录: {work_dir}
{若 discuss 类型} 最大讨论轮次: {max_rounds}
</project_context>

<team_members>
{列出所有成员的名称和角色}
</team_members>

<workflow_overview>
{仅 workflow.md 中「阶段总览」表格，不含各 Phase 详细流程}
</workflow_overview>

<your_role>
{对应角色 .md 文件的完整内容}
</your_role>
```

#### 扩展角色的 Prompt

扩展角色（`ext-` 前缀）使用与执行角色相同的 prompt 结构（`<workflow_overview>` 而非完整 workflow），并额外标注扩展角色来源：

```
你是「{project_name}」项目的{role_name}（扩展角色 — {department}）。

<project_context>
项目名称: {project_name}
团队类型: {team_type_name}
项目描述: {description}
技术栈: {tech_stack}
工作目录: {work_dir}
{若 discuss 类型} 最大讨论轮次: {max_rounds}
</project_context>

<team_members>
{列出所有成员的名称和角色}
</team_members>

<workflow_overview>
{仅 workflow.md 中「阶段总览」表格，不含各 Phase 详细流程}
</workflow_overview>

<your_role>
{扩展角色 .md 文件的完整内容}
</your_role>
```

#### 远程角色的 Prompt

远程角色（`source: remote`）根据 `verified` 状态使用不同 prompt：

**远程 verified 角色**：与内置扩展角色同等处理，标注远程来源：

```
你是「{project_name}」项目的{role_name}（远程角色 — {source}）。

<project_context>
项目名称: {project_name}
团队类型: {team_type_name}
项目描述: {description}
技术栈: {tech_stack}
工作目录: {work_dir}
{若 discuss 类型} 最大讨论轮次: {max_rounds}
</project_context>

<team_members>
{列出所有成员的名称和角色}
</team_members>

<workflow_overview>
{仅 workflow.md 中「阶段总览」表格，不含各 Phase 详细流程}
</workflow_overview>

<your_role>
{角色 .md 文件的完整内容}
</your_role>
```

**远程 unverified 角色**：在 `<your_role>` 内容前追加格式提示：

```
你是「{project_name}」项目的{role_name}（远程角色 — {source}）。

<project_context>
项目名称: {project_name}
团队类型: {team_type_name}
项目描述: {description}
技术栈: {tech_stack}
工作目录: {work_dir}
{若 discuss 类型} 最大讨论轮次: {max_rounds}
</project_context>

<team_members>
{列出所有成员的名称和角色}
</team_members>

<workflow_overview>
{仅 workflow.md 中「阶段总览」表格，不含各 Phase 详细流程}
</workflow_overview>

<your_role>
注意：此角色定义未遵循标准 5-Block 格式，请尽量按照 <role>/<rules>/<deliverables>/<collaboration>/<metrics> 结构理解和执行其中的指示。

{角色 .md 文件的完整内容}
</your_role>
```

### 步骤 6: 创建初始任务

使用 TaskCreate 根据 workflow.md 的阶段创建任务骨架。
设置阶段间的 blockedBy 依赖关系。
将第一个任务分配给 Lead 角色。

### 步骤 7: 派生团队成员（Agent 工具 + team_name）

**Lead 角色必须第一个创建。** 注意：多实例角色（如 developer x2）的每个实例使用相同的角色定义文件。

> **`team_name` 参数是团队成员与普通 subagent 的唯一区别。** 必须填写步骤 3 中 TeamCreate 注册的团队名称。缺少 `team_name` 的 Agent 调用将创建独立 subagent，无法加入团队协作。

```
Agent:
  name: "{member_name}"
  subagent_type: "general-purpose"
  team_name: "{project_name}"       # ← 必须与步骤 3 TeamCreate 的 team_name 一致
  prompt: "{步骤 5 构建的 prompt}"
  mode: "bypassPermissions"
  description: "Team member: {role_name}"
```

命名规则：
- 单实例角色: 直接使用代号 (pm, architect, captain 等)
- 多实例角色: 代号-序号 (developer-1, web-2 等)
- 扩展角色: 使用完整代号 (ext-marketing-xiaohongshu, ext-design-ui-designer 等)

创建顺序：先创建 Lead，再并行创建其他角色。

### 步骤 8: 保存团队配置到项目目录

将团队配置保存到项目工作目录下的 `.team-profiles/{project_name}.yaml`，以便后续通过 `/team-load` 复用。

使用 Write 工具创建文件：

```yaml
# 团队配置 - 由 /team-init 自动生成
# 使用 /team-load {project_name} 可直接加载此配置创建团队

format: template
team_type: "{type_dir}"           # dev/testing/reverse/debug/security/ctf/ops/discuss
team_type_name: "{team_type_name}" # 中文名称
description: "{description}"
tech_stack: "{tech_stack}"
work_dir: "{work_dir}"

roles:
  # Lead 角色（自动包含）
  - role: "{lead_role_code}"
    count: 1
    is_lead: true
  # 核心角色
  - role: "{role_code}"
    count: {N}
  # ... 列出所有选中的核心角色及数量

  # 扩展角色（如有）
  # - role: "ext-{department}-{role_code}"
  #   count: 1
  #   source: extension
  #   department: "{department}"

  # 远程角色（如有）
  # - role: "{role_code}"
  #   count: 1
  #   source: remote
  #   remote_source: "{source}"
  #   verified: true/false
```

保存后输出提示：
```
团队配置已保存到: {work_dir}/.team-profiles/{project_name}.yaml
后续可使用 /team-load {project_name} 直接加载此团队配置。
```

### 步骤 9: 通知 Lead 启动

```
SendMessage:
  type: "message"
  recipient: "{lead_name}"
  content: |
    团队已创建完成。
    - 项目: {project_name}
    - 描述: {description}
    - 技术栈: {tech_stack}
    - 工作目录: {work_dir}
    - 团队成员: {member_list}

    请开始第一阶段工作。
    工作流: {work_dir}/.teams/{project_name}/workflow.md
    角色定义: {work_dir}/.teams/{project_name}/roles/
  summary: "团队已创建，启动项目"
```

## 复用已有 .teams/ 目录

如果执行 `/team-init` 时检测到 `{work_dir}/.teams/{project_name}/` 已存在（例如上次取消后保留的），跳过步骤 1 的文件写入，直接进入步骤 2（用户审阅）。

提示用户：

```
检测到已有角色定义: .teams/{project_name}/
将使用其中的角色文件创建团队（包含您之前的修改）。

如需重新生成，请先删除 .teams/{project_name}/ 目录。
```

## 注意事项

- `.teams/` 目录应加入 `.gitignore`（属于本地自定义，不入版本控制）
- 多实例角色（如 developer x3）共用同一个角色定义 MD，修改一次影响所有实例
- 用户修改角色 MD 后，修改内容会被原样注入到 agent 的 `<your_role>` 段

## 参考资源

- **`references/role-catalog.md`** - 各团队类型的完整角色列表
- **`references/{type_dir}/roles/{role}.md`** - 各角色详细定义（原始版本）
- **`references/{type_dir}/workflow.md`** - 各团队类型的工作流定义
- **`references/shared/handoff-protocol.md`** - 跨角色交接协议
- **`references/shared/role-template.md`** - 角色定义标准模板
- **`references/extensions/extension-catalog.md`** - 扩展角色索引（153 个跨 12 领域）
- **`references/extensions/{department}/{role_code}.md`** - 扩展角色定义

## 脚本工具

- **`scripts/lint-roles.sh`** - 角色定义文件格式校验（5板块结构检查）
  - `bash <skill_base>/scripts/lint-roles.sh` — 检查所有核心角色
  - `bash <skill_base>/scripts/lint-roles.sh dev` — 检查 dev 团队
  - `bash <skill_base>/scripts/lint-roles.sh --extensions` — 检查扩展角色
  - 脚本使用 `${BASH_SOURCE[0]}` 自动定位，任何安装位置均可工作