代理团队协作实战：5 步从零搭好多 Claude 会话工作流

代理团队协作实战5 步从零搭好多 Claude 会话工作流【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-best-practiceclaude-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 和 iTerm2macOS 示例Linux 用系统包管理器装 tmux 即可brew install --cask iterm2 brew install tmux代理团队会并行跑多个会话tmux 分屏能让你同时看到每个成员的动作。其余依赖见仓库 README。走一遍完整流程任务让一个代理团队从零搭建时间编排工作流再用/time-orchestrator跑出迪拜时间 SVG 卡片。启动开启特性的会话tmux new -s dev CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1 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），仅供参考