☰
three-man-team Windows安装指南:Git Bash、WSL与手动配置三种方案对比
2026/10/23 4:10:22 网站建设 项目流程

【免费下载链接】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.

项目地址:https://gitcode.com/gh_mirrors/th/three-man-team
点击查看免费下载

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.

项目地址:https://gitcode.com/gh_mirrors/th/three-man-team
点击查看免费下载
上一篇:LikeC4区块链架构:分布式系统的可视化表示
下一篇:VoiceStudio:免费跑在本地电脑的语音克隆工作台,覆盖 646 种语言

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询