【免费下载链接】three-man-team
A structured 3-agent AI dev team — Architect, Builder, Reviewer. Built from production use. Token-optimized. Works with Claude Code, VS Code, Cursor, and any AI that supports context files.
three-man-team 是一个结构化的 AI 三智能体开发团队——Architect(架构师)、Builder(开发者)、Reviewer(评审员),从生产环境实战中打磨而来,兼容 Claude Code、VS Code、Cursor 等支持上下文文件(context files)的 AI 工具。本文专注three-man-team Windows安装:官方的 setup 脚本运行在 bash 环境,无法在 PowerShell 或命令提示符中直接执行,因此 Windows 用户需要选择合适的环境。下面将Git Bash、WSL、手动配置三种方案逐一演示并横向对比,帮助你快速完成安装。
three-man-team Windows安装前的3项准备
开始之前,先确认你的机器已具备以下三个条件:
| 准备项 | 是否必需 | 说明 |
|---|---|---|
| Git | ✅ 必需 | 用于克隆仓库;Windows 版 Git 自带 Git Bash |
| Claude Code CLI | ✅ 必需 | three-man-team 的运行载体,团队全部在一个会话中工作 |
| bash 环境 | 视方案而定 | Git Bash / WSL 需要;手动配置方案不需要 |
⚠️ 关键点:three-man-team 的安装脚本 setup 是 bash 脚本,不会在 PowerShell 或 Command Prompt 中运行。这一点直接决定了下面三种方案的存在。
方案一:Git Bash 安装 three-man-team(推荐)
Git for Windows 安装后自带 Git Bash,对大多数 Windows 用户来说这是最快、最简单的安装路径,全程只有 3 条命令。
第 1 步:打开 Git Bash,进入你的项目目录(Git Bash 中 Windows 盘符需写成小写前缀,如D:→/d):
cd /d/your-project第 2 步:克隆到项目的.claude/skills/three-man-team目录:
git clone https://gitcode.com/gh_mirrors/th/three-man-team .claude/skills/three-man-team第 3 步:运行安装脚本:
cd .claude/skills/three-man-team bash setup💡 小提示:建议用bash setup而不是./setup,可以避免 Windows 换行符或执行权限带来的报错。
脚本会检测 Claude Code 是否已安装,并打印后续步骤——照着它输出的提示操作即可。完成后,在项目目录中打开 Claude Code,粘贴这段首次启动指令:
You are the Architect on this project. Please read new-setup.md.Arch(架构师)会接过后续流程:介绍团队、配置项目上下文文件、生成每次会话使用的提示词。
方案二:在 WSL 环境中安装 three-man-team
如果你平时就在 WSL 中开发,或者希望获得完整的 Linux 命令行体验,这个方案更合适。
第 1 步:在 PowerShell(管理员)中安装 WSL:
wsl --install第 2 步:在 WSL(默认 Ubuntu)中安装 Git 和 Claude Code CLI:
sudo apt update && sudo apt install git第 3 步:进入项目目录执行与方案一相同的命令:
cd ~/my-project git clone https://gitcode.com/gh_mirrors/th/three-man-team .claude/skills/three-man-team cd .claude/skills/three-man-team bash setup两个 WSL 特有的注意点:
- 路径映射:Windows 下
D:\projects\my-app在 WSL 中是/mnt/d/projects/my-app; - 性能建议:把项目放在 WSL 家目录(如
~/projects)中访问速度更快,跨文件系统读写D 盘会明显变慢。
方案三:手动配置 three-man-team(无需 bash)
不想装 bash 环境?完全可以。手动方案的核心就是:把角色文件复制到项目根目录,然后启动 AI 会话。
第 1 步:获取仓库(克隆或下载源码均可),找到项目级模板目录 templates/project-folder/。
第 2 步:将该目录全部内容复制到你的项目根目录,复制完成后项目里会多出以下文件:
| 文件 / 目录 | 作用 |
|---|---|
| ARCHITECT.md | 架构师 Arch 的角色定义 |
| BUILDER.md | 开发者 Bob 的角色定义 |
| REVIEWER.md | 评审员 Richard 的角色定义 |
| new-setup.md | 首次启动时的设置向导 |
handoff/ | 三个角色之间交接文件的目录 |
第 3 步:打开 Claude Code,粘贴首次启动指令:
You are the Architect on this project. Please read new-setup.md.第 4 步:跳过 RTK 的安装。three-man-team 配套的 token 压缩工具 RTK 目前不支持 Windows,直接忽略该步骤即可,不影响核心功能。
three-man-team 安装完成后的工作方式
无论哪种方案,安装后的工作方式完全一致:所有角色运行在同一个 Claude Code 会话里,Arch 是主智能体,需要编码时通过 Agent 工具拉起 Bob,Bob 完成后 Arch 再拉起 Richard 评审——你不需要开三个窗口。
两个安装后必须注意的规则:
- 🚫不要把 Builder / Reviewer 作为后台智能体运行。后台模式收不到工具审批弹窗,Builder 第一次写文件时就会卡死。使用 Agent 工具时保持
run_in_background为默认(前台)即可; - 每次会话开始时 Arch 会读取 releases/latest.json 检查版本,关键更新属于强制检查点,由你确认后才应用。
Git Bash、WSL、手动配置:三种方案怎么选?
| 方案 | 需要 bash | 难度 | 适合人群 |
|---|---|---|---|
| Git Bash | 需要 | ⭐ 最简单 | 普通 Windows 用户,装完 Git 就能用 |
| WSL | 需要 | ⭐⭐ | 已有 WSL 环境、偏爱 Linux 命令行 |
| 手动配置 | 不需要 | ⭐⭐ | 不熟悉命令行、只想快速用起来 |
选择建议:
- 默认选Git Bash——命令最少、路径就是 Windows 原生路径,后续维护也直观;
- 你的项目本来就在 WSL 里跑,直接用WSL 方案,省掉跨文件系统切换的麻烦;
- 只想先体验、不想碰终端,选手动配置,复制文件 + 粘贴一句提示词就完成。
总结
three-man-team 的 Windows 安装没有玄学:脚本要求 bash,因此要么提供 bash(Git Bash 或 WSL),要么绕开脚本手动复制 templates/project-folder/ 模板文件。三种方案装完后的体验完全相同——一个会计划、会开发、会评审,且严格按"计划 → 构建 → 审查 → 部署"流程协作的 AI 团队。
更多资料可直接在仓库中查阅:
- 官方安装说明:INSTALL.md
- 团队工作机制详解:docs/how-it-works.md
- Token 优化规则(含 CLAUDE.md 中的五条会话规则):docs/token-optimization.md
- 通用空白模板(适合全局安装):templates/generic/
- 一个完整的实战示例(从需求到部署):examples/sprint-walkthrough.md
【免费下载链接】three-man-team
A structured 3-agent AI dev team — Architect, Builder, Reviewer. Built from production use. Token-optimized. Works with Claude Code, VS Code, Cursor, and any AI that supports context files.
相关推荐
fauxnix vs WSL vs Git Bash vs 原生PowerShell:AI Agent 的 4 种 Windows 终端方案终极对比
fauxnix vs WSL vs Git Bash vs 原生PowerShell:AI Agent 的 4 种 Windows 终端方案终极对比 ! fau
如何10分钟上手three-man-team:两种安装模式+setup脚本完整教程(附新手避坑清单)
如何10分钟上手three man team:两种安装模式+setup脚本完整教程(附新手避坑清单) three man team 是一款开源的三代理 AI 开
awesome-design-md 新手指南:用一份 DESIGN.md 文件,让 AI 生成任意大牌风格界面
awesome design md 新手指南:用一份 DESIGN.md 文件,让 AI 生成任意大牌风格界面 awesome design md 是一个收录
文档
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考