Agent Team，从零构建 Claude Code Agent 工作流

一个人指挥一支 AI 乐队，你准备好了吗？

「我想用 Claude Code 自动化我的工作。」

「我想让 AI 帮我处理重复任务。」

「我想构建一个自己的 Agent。」

这些都是美好的愿望。但从「想」到「做」，中间隔着的，是如何设计一个真正可用的工作流。

今天，用三个步骤，介绍从 0 构建一个 Claude Code Agent 工作流的方法。

一、设计阶段：定义你的「AI 军团」

一个好的 Agent 工作流，始于角色定义。

不是「一个 AI 帮我干活」，而是「一群 AI 各司其职」。Anthropic 的实验已经证明：16 个并行 Agent 可以完成 10 万行代码的编译器。关键在于——每个人做自己擅长的事。

典型的角色设计包括：

• UI Agent：负责前端界面
• API Agent：负责后端逻辑
• Database Agent：负责数据层
• QA Agent：负责测试和验证
• Docs Agent：负责文档维护

这和软件工程的单一职责原则一脉相承——让每个 Agent 专注于一个领域，做到极致。

Agent Teams 更具体的配置步骤：

1. 创建 team 目录结构
2. 定义每个 teammate 的角色和职责
3. 配置任务分配机制
4. 设置通信协议

核心原则：任务解耦、边界清晰、结果可汇总。

二、配置阶段：让 Agent 学会「沟通」

角色定义好了，接下来是配置：让 Agent 知道什么时候该找谁、怎么分工。

2.1 MCP：连接外部世界的「万能插头」

Claude Code 的杀手锏之一是 MCP。你可以把它理解为 AI 世界的「USB-C」，一个统一的标准，让 AI 可以连接任何外部工具。

目前主流的 MCP 工具包括：

• Playwright MCP：浏览器自动化
• GitHub MCP：代码管理和 PR 操作
• Shadcn MCP：UI 组件浏览和安装
• Jira MCP：项目管理
• Slack MCP：团队沟通

如何配置（示例）：

## MCP Servers
### Shadcn UI MCP
当使用 Shadcn UI 组件时，始终使用 Shadcn MCP 浏览可用组件仓库。
永远不要直接运行终端命令。

这就是配置的魔力——AI 不是在「猜」该用什么工具，而是被明确告知该用什么。

2.2 权限与审批：信任但要验证

Claude Code 内置了一个精妙的权限系统：读取操作默认开放，但写入操作需要用户审批，危险操作（如删除文件）强制需要确认。

这体现了人机协作的最佳平衡——既释放了 AI 的生产力，又确保人类始终是最后一道防线。

2.3 通信机制：Agent 之间怎么聊天？

这个方案很有趣：用 Git 做同步

• Agent 通过写文件来「锁定」任务
• 完成后 push 到共享仓库
• 其他 Agent pull 最新更改
• Git 自动解决冲突（Claude 很聪明，能自己处理）

这就是去中心化协作的魅力——没有中央调度器，每个 Agent 自主决策，通过共享状态来协调。

三、自动化阶段：让机器跑起来

设计完成，配置就绪。现在是让系统自动跑起来。

3.1 Agent Loop：永不停歇的循环

一个关键模式：

while true; do
  claude --dangerously-skip-permissions -p "$(cat AGENT_PROMPT.md)"
done

这就是 Agent Loop，任务完成后立即拾取下一个，无需人类持续输入。

但这里有一个关键洞察：测试必须近乎完美。

Claude 会自主解决你给它的任何问题。所以任务验证器必须近乎完美，否则 Claude 会解决错误的问题。

官方在项目中构建了：

• 高质量编译器测试套件
• 持续集成流水线
• 严格的回归测试

结果是：99% 测试通过率。

3.2 实际案例：一个「文档 Agent」的诞生

让我用一个具体案例来说明这个过程。

场景：每次代码变更后，自动更新项目文档

步骤 1 - 设计：

• Docs Agent 负责文档维护

步骤 2 - 配置：

## Workflows
每次代码合并后：
1. 检查文档与代码的一致性
2. 更新 API 文档
3. 生成变更日志
4. 提交 PR

步骤 3 - 自动化：

• 配置 GitHub Actions 触发
• Agent 自动运行文档更新流程
• 人类审批后合并

这就是一个完整的 Agent 工作流：从设计到配置到自动化。

四、致最先触达未来的那一小部分人

构建 Agent 工作流，本质上是在设计一个AI 组织的治理结构。

• 设计阶段：定义角色和职责
• 配置阶段：建立通信和权限机制
• 自动化阶段：让系统自主运行

这不是写代码。这是设计「AI 社会的组织架构」。

正如 Anthropic 所说：

Agent teams 展示了实现整个复杂项目的可能性。这让我们，作为这些工具的用户，能够设定更宏大的目标。

今天，就创建一个属于你的 Agent Team。

claude → /help → 开始探索。

致最先触达未来的那一小部分人。

参考文献

[1] Medium: How to Set Up and Use Claude Code Agent Teams.

[2] Claude Code Overview.

[3] Anthropic Engineering: Building a C compiler with a team of parallel

[4] Reddit r/ClaudeCode: Agent Teams Discussion.

[5] shadow的笔记.md: Claude Code