claude-code-best-practice AI 代理团队协作完整指南：一次跑通多会话编排工作流

claude-code-best-practice AI 代理团队协作完整指南一次跑通多会话编排工作流【免费下载链接】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 是 AI 代理团队协作的实战仓库教你用命令 Command、子代理 Sub-agent、技能 Skill 三层机制编排多个 Claude Code 会话并行工作把一条完整任务从提示词跑到输出文件一次跑通。从一个真实任务说起迪拜时间到 SVG 卡片的 4 步链路仓库里有一个可直接运行的示例把迪拜当前时间渲染成 SVG 卡片。先看结果——你只需 4 步你在会话里输入/time-orchestrator命令通过 Agent 工具调用time-agent获取 Asia/Dubai 时区的当前时间time-agent返回三个字段time、timezone、formatted命令再通过 Skill 工具调用time-svg-creator写出agent-teams/output/下的dubai-time.svg和output.md打开 SVG你就看到一张带时间、时区、日期的卡片output.md里是同样信息的文字摘要。整条链路没有任何自定义代码跑起来的是 Command → Agent → Skill 这条流水线是 Claude Code 多会话编排的典型形态。还有一个值得注意的细节这个示例的命令、代理、技能本身就是由三人代理团队写出来的而不是人写的。跑通它从克隆到第一次调用的最快启动方式全程 4 组命令没有服务依赖。先拿到代码git clone https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice代理团队是多个并行终端窗格所以要先装 tmuxMac 上再配 iTerm2 获得分屏体验brew install --cask iterm2 brew install tmux启动一个命名 tmux 会话然后带着环境变量启动 Claude。这步最容易漏CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1是代理团队实验功能的开关不加它就只是个普通单会话tmux new -s dev CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1 claude在会话里粘贴agent-teams/agent-teams-prompt.md的团队提示词会并行生成 Command Architect、Agent Engineer、Skill Designer 三个队友分别把命令、代理、技能建好。提示词同时要求所有文件都放在agent-teams/.claude/下保证工作流自包含。完成后就能运行成品cd agent-teams claude /time-orchestrator命令、代理、技能3 层机制怎么分工三层不是为了分层而分层。每一层只谈两件事负责什么、和相邻层怎么交接数据契约。命令入口与编排者。负责用户交互和调用顺序把数据契约直接写进调用提示词里要求代理恰好返回三个字段。路径agent-teams/.claude/commands/time-orchestrator.md。代理数据获取者。预加载time-fetcher技能用 Bash 跑指定时区的date只返回time/timezone/formatted三字段不多不少。路径agent-teams/.claude/agents/time-agent.md。技能渲染者。消费上下文里已有的时间数据渲染并写盘明确要求绝不重新获取避免二次取数造成不一致。路径agent-teams/.claude/skills/time-svg-creator/SKILL.md。技能其实有两种用法预加载进代理作为领域知识如time-fetcher或由命令通过 Skill 工具直接调用如time-svg-creator示例两种都演示了。 契约就是一组字段名不是口头承诺代理不返回三个字段下一层渲染就没有输入。所以示例把契约同时写进了命令文件和代理文件。让多代理不打架的 4 招多会话并行时冲突是常态。仓库里的做法都可以直接照搬角色单一职责。每个队友只做一件事命令只编排、代理只取数、技能只渲染改一处不牵连别处。共享任务列表当契约谈判桌。动手前三个队友先在共享任务列表上把{time, timezone, formatted}对齐之后并行开工互不等待对方的实现。模块化才能换。所有组件都收在agent-teams/.claude/里把time-*三件套整套换成天气、日程就是另一条工作流。上下文靠窗口管。每个队友有独立上下文窗口CLAUDE.md、MCP 服务器、技能自动加载会话变长后用/compact或/clear压缩重置。高频问题它和子代理 Sub-agent 到底什么区别子代理是单个会话内的隔离上下文分支只把最终结果带回主会话。代理团队是多个独立的 Claude Code 会话每个成员都有完整上下文窗口各自自动加载 CLAUDE.md、MCP 服务器和技能。需要哪些前置依赖Claude Code 本身加 tmuxMac 建议配 iTerm2。环境变量CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1打开实验开关即可没有其他依赖。上下文窗口怎么控制每个队友的会话彼此隔离主会话只留编排对话不会被中间过程污染。另外可用maxTurns限制代理的回合数time-agent就设了 3。必须从零搭建团队吗不必。仓库自带成品团队提示词agent-teams/agent-teams-prompt.md粘贴即用。延伸阅读implementation/claude-agent-teams-implementation.md — 适合想从零搭代理团队的人含完整协作流程图orchestration-workflow/orchestration-workflow.md — 适合想深入 Command → Agent → Skill 流水线的人含逐步执行示例best-practice/claude-subagents.md — 适合需要子代理字段与内置类型速查表的子代理协作教程读者以上均为仓库内相对路径从仓库根目录即可打开。【免费下载链接】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），仅供参考