3个角色并行干活一条指令跑通全流程claude-code-best-practice代理团队协作入门【免费下载链接】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仓库的agent teams代理团队协作机制让多个独立的Claude Code会话组队干活靠一张共享任务列表对齐进度并行搭出一条Command → Agent → Skill编排工作流。单会话写码的两个翻车现场第一个现场你和模型在一个会话里改了三轮需求它开始忘记第五轮之前约定好的命名规范和输出格式代码风格越跑越飘。第二个现场取数、渲染、写文档三件事塞进同一个上下文窗口每件事的中间状态都在挤占另外两件的注意空间任务越多跑得越慢。根子在于单会话里所有工作共用一份上下文窗口。代理团队协作的思路是拆开来每个队友都是独立的Claude Code会话自带完整上下文窗口启动时自动加载CLAUDE.md、MCP服务器给模型接外部工具用的服务端和技能队友之间靠共享任务列表对齐——它就像团队群里发的进度表每个人都能看到都能勾选更新。它和Sub-agents子代理不是一回事子代理只是同一会话里分叉出的隔离上下文而agent teams拉起的是真实并行的多个会话各自跑工具、读文件互不挤占。一条指令从输入到产出协作流程怎么跑拿仓库里的时间编排工作流把整条流转看一遍入口命令。你敲下 /time-orchestrator定义在 agent-teams/.claude/commands/time-orchestrator.md。命令不取数据只负责编排先调代理、再调技能、最后汇总输出。代理执行。命令通过Agent工具唤起 time-agentagent-teams/.claude/agents/time-agent.md。这个代理启动时预加载了 time-fetcher 技能照着里面的指令执行 TZAsia/Dubai date 拿到当前时间再按 {time, timezone, formatted} 的固定结构返回给命令。技能处理。命令拿到数据后通过Skill工具调用 time-svg-creator 技能agent-teams/.claude/skills/time-svg-creator/。技能不重新取时间直接拿上下文里的数据渲染SVG卡片。结果输出。SVG写到 agent-teams/output/dubai-time.svg摘要写到 agent-teams/output/output.md。三个组件之间唯一要谈拢的就是第2步返回的数据结构也就是数据契约。搭团队时三个角色会把契约写成共享任务列表里的待办项确认后才各自开工谁也不用等谁的实现。5步跑通你的第一个代理团队克隆仓库git clone https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice把示例代码拉下来其中 agent-teams/ 目录就是你的试验场。安装 tmuxmacOS用户可顺带装上iTerm2纯tmux也够用brew install tmux它把终端切成多个分屏几个队友的会话能同屏看到。新建一个tmux会话tmux new -s dev后续操作都在这个会话里进行关掉窗口进程也不会断。带实验开关启动ClaudeCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1 claude这个环境变量是团队能力的入口不加的话Claude只会以单会话模式运行。粘贴建队提示词。完整提示词在 agent-teams/agent-teams-prompt.md它要求创建Command Architect、Agent Engineer、Skill Designer三个角色搭一条时间编排工作流且所有产物必须落在 agent-teams/.claude/ 下。整段贴进Claude它会拉队伍、分任务、并行开工。新手最常踩的几个坑 如果你发现Claude只是嘴上答应组队实际没拉出并行会话那大概率是忘了加 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1——团队能力目前是实验特性不显式开启就不存在。 如果你发现 cd agent-teams claude 之后命令和代理都加载不到先检查文件是不是被写进了仓库根目录的 .claude/。建队提示词里要写死一条所有文件落在 agent-teams/.claude/ 下团队产物才自包含、能独立跑。如果输出卡片的时间和代理刚取到的对不上那多半是技能组件重新取了一次时间而不是消费代理返回的 {time, timezone, formatted} 数据契约。另一个易错点命令唤起代理必须走Agent工具、唤起技能必须走Skill工具用bash硬调不会带上预加载的技能和独立上下文。走读一遍时间编排工作流怎么跑这条流程本身就是agent teams自己搭的现在跑一遍成品cd agent-teams claude /time-orchestrator前两句切进团队自己的工作目录并起Claude只加载 agent-teams/.claude/ 里的配置第三句触发整条管线。中间发生了什么命令唤起 time-agent代理按预加载的 time-fetcher 技能执行 TZAsia/Dubai date 取到迪拜时间UTC4把 {time, timezone, formatted} 交回命令命令再调 time-svg-creator技能用模板渲染卡片。最终产出两个文件SVG时间卡片 agent-teams/output/dubai-time.svg以及摘要 agent-teams/output/output.md里面记着取到的时间、时区GST, UTC4和完整时间串。接下来往哪走换业务重搭把提示词里的迪拜时间换成汇率、库存等任何取数据渲染卡片的场景三个角色的分工逻辑不变。天气编排工作流 orchestration-workflow/orchestration-workflow.md 是另一条完整管线还演示了预加载技能与独立技能两种用法值得对照读。划清和子代理的边界长任务、可并行用团队短平快的隔离任务用Sub-agents更省。对照 best-practice/claude-subagents.md 读一遍选型会清楚很多。积累日常手感tips/ 目录按作者整理了Boris Cherny、Thariq的实操系列覆盖记忆管理、上下文压缩、模型档位调节这些高频话题。相关链接仓库主文档CLAUDE.md代理团队实现指南implementation/claude-agent-teams-implementation.md建队提示词可直接复制agent-teams/agent-teams-prompt.md编排工作流文档orchestration-workflow/orchestration-workflow.md子代理最佳实践best-practice/claude-subagents.md团队命令定义agent-teams/.claude/commands/团队代理配置agent-teams/.claude/agents/团队技能模块agent-teams/.claude/skills/【免费下载链接】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），仅供参考