AgentTeam 是 JiuwenClaw 的多智能体协同模式，通过 TeamSkills 机制将多个专业 Agent 组织为团队，分工完成复杂任务。本文档覆盖从启动到任务执行的完整流程。

本文档回答的问题：如何启动 AgentTeam 模式？需要哪些前置配置？如何安装技能并组建团队执行协同任务？

---

一、启动服务

启动 JiuwenClaw 开发环境前，需依次完成代码更新、依赖同步、前端构建三个步骤。

# 更新代码
git pull

# 更新依赖
source ./venv/bin/activate
uv sync

# 更新前端
cd jiuwenclaw/web
npm i
npm run build

# 启动开发服务
cd ../../
jiuwenclaw-start dev

执行 jiuwenclaw-start dev 后，服务默认监听 localhost:5173。如端口被占用，检查环境变量或启动日志中的端口配置。

---

二、检查配置项

服务启动后，访问 http://localhost:5173/ 进入管理界面，逐一确认模型与频道配置。

模型配置：检查已接入的模型列表，确认各模型 API Key 有效、连接正常。

频道配置：确认频道中各模型的调用参数与路由规则正确。

⚠️ 使用 Team 模式时，必须开启流式输出。否则多 Agent 协同过程中的中间结果无法实时推送，团队协调将失败。

---

三、安装 TeamSkills

TeamSkills 是 AgentTeam 的能力单元，定义了团队中各 Agent 的角色、工具与协作规则。

方式一：在线安装

进入「技能 → TeamSkills 在线检索」，搜索关键词（如 "wise"）找到目标技能包，点击安装。

以 WiseDev Team 为例，安装后技能目录位于：

~/.jiuwenclaw/agent/jiuwenclaw_workspace/skills/wisedev-team

方式二：自动生成

先安装 teamskill-creator（团队技能自动生成专家），通过该技能按业务需求创建自定义 TeamSkills。

安装方式	适用场景	产出位置
在线检索安装	使用社区或官方预置技能	~/.jiuwenclaw/agent/.../skills/
teamskill-creator 生成	按业务需求定制专属技能	同上

---

四、组建团队与执行任务

安装 TeamSkills 后，切换到 Team 模式，组建团队并指派工作空间与任务。团队将自动分解任务、分配角色、协同执行。

步骤一：切换模式

在对话界面输入 /mode team 切换到 AgentTeam 模式。

步骤二：组建团队

指定 TeamSkills 路径并组建团队：

组建 ~/.jiuwenclaw/agent/jiuwenclaw_workspace/skills/wisedev-team 团队

步骤三：指派任务

指定工作空间目录和任务描述。团队将根据任务自动分配各 Agent 的职责并协同推进。

任务描述应清晰界定工作范围、核心流程和约束条件。模糊的任务描述会导致 Agent 角色分配不明确，影响协同效率。

步骤四：验证结果

任务执行完成后，检查产出物是否符合预期。

完整流程回顾：启动服务 → 检查配置 → 安装 TeamSkills → /mode team → 组建团队 → 指派任务 → 验证结果

---

术语表

• AgentTeam：JiuwenClaw 的多智能体协同模式，多个 Agent 以团队形式分工完成复杂任务。
• TeamSkills：定义团队中各 Agent 角色、工具和协作规则的技能包。
• teamskill-creator：自动生成 TeamSkills 的辅助技能，按业务需求创建定制化团队技能。
• WiseDev Team：面向软件研发全流程的预置 TeamSkills，覆盖需求、设计、开发等环节。
• 流式输出：Agent 协同过程中逐步推送中间结果的能力，Team 模式的必要前置条件。