代理团队协作实战：5 步从零搭好多 Claude 会话工作流
【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice
claude-code-best-practice 这个项目讲的核心问题，就是代理团队协作：一次性拉起多个独立的 Claude Code 会话，让它们通过共享任务列表互相协调，把一条工作流拆给几个"人"分工完成。读完这篇，你可以在自己项目里跑通一遍：创建一个三角色的代理团队，让它们从零搭出"迪拜时间卡"工作流，再用一条命令产出真实的 SVG 结果。
它到底是怎么"组队"的
代理团队协作会同时启动多个独立的 Claude Code 会话。它和子代理（subagent，单个会话内的隔离上下文分支）的区别在于：团队成员是完整的独立会话，自动加载 CLAUDE.md、MCP 服务器和技能，各自拥有完整的上下文窗口。仓库里agent-teams/目录就是一个可运行的完整例子：Command Architect、Agent Engineer、Skill Designer 三个角色组成的团队，搭出了一条"获取迪拜当前时间并渲染成 SVG 时间卡"的工作流。
环境准备：两条命令搞定
- 克隆仓库：
git clone https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice cd claude-code-best-practice- 安装 tmux 和 iTerm2（macOS 示例，Linux 用系统包管理器装 tmux 即可）：
brew install --cask iterm2 brew install tmux代理团队会并行跑多个会话，tmux 分屏能让你同时看到每个成员的动作。其余依赖见仓库 README。
走一遍完整流程
任务：让一个代理团队从零搭建时间编排工作流，再用/time-orchestrator跑出迪拜时间 SVG 卡片。
- 启动开启特性的会话
tmux new -s dev CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude环境变量打开实验性特性，缺了它，组队功能不会生效。
- 粘贴提示词创建团队
agent-teams-prompt.md 里的提示词开头是：
Create an agent team to build a time orchestration workflow that displays the current Dubai time as a visual SVG card...它定义了三个角色、各自的产物路径，并要求所有文件都写在agent-teams/.claude/下。
- 看它们先定"数据契约"
三个成员并行开工，先在共享任务列表上约定数据契约：agent 返回 time、timezone、formatted 三个字段，命令原样传递，技能直接消费。契约敲定后，各自再写自己的文件。
- 运行成品
cd agent-teams claude /time-orchestrator预期结果：摘要写入agent-teams/output/output.md，时间卡片生成在agent-teams/output/dubai-time.svg。output.md 内容就是时间、时区、完整时间戳三项。
核心机制速拆
Command 是总调度
time-orchestrator.md 是唯一的入口：先用 Agent 工具调 time-agent 取时间，再用 Skill 工具调 time-svg-creator 渲染。文件里明确要求顺序执行、禁止并行——否则技能拿不到数据。如果没有这一层命令，只让一个 agent 从头干到尾，就没有人盯流程、出错也没人兜底。
每个成员有独立上下文窗口
每个成员都是全新会话，自动加载 CLAUDE.md、MCP 服务器和自己的技能；time-agent 还通过skills:字段预加载了 time-fetcher，并用maxTurns: 3限制它别跑偏。换成子代理方案的话，所有成员共享一个上下文窗口，任务一长就容易互相污染。
技能只消费，不重取
time-svg-creator 被明确要求：只用上下文里已有的时间数据，绝不重新获取。它要是真去重跑一次取数，卡片上的时间和命令汇报的对不上。
实操中容易踩的 3 个坑
- ⚠️ 忘加环境变量：直接敲
claude启动，组队功能不会生效。 - ⚠️ 文件放错目录：写进仓库根目录
.claude/而不是agent-teams/.claude/，成品在子目录里加载不到。 - ⚠️ 用 bash 调 agent：命令文件里专门写了"必须用 Agent 工具，不许用 bash"，措辞含糊时模型真的会去跑 shell 命令。
延伸文档
- agent-teams-prompt.md：建队提示词原文，适合学"角色 + 产物 + 契约"式提示词的写法。
- claude-agent-teams-implementation.md：代理团队完整实现指南，含团队协调流程图。
- claude-subagents.md：子代理的配置方法，适合用来对比子代理与代理团队两种机制的差异。
- orchestration-workflow.md：天气系统的完整流程图，可以再学一个 Command→Agent→Skill 的例子。
下一步可以试试：把"迪拜时间"换成你项目里一个真实的小任务，用同样结构的提示词拉起三个角色的团队，自己跑一遍。
【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
