| 工具 | 版本 | 用途 |
|---|---|---|
| bash | 3.2 以上（macOS 自带的就行） | 运行 aiwf |
| git | 任意近期版本 | |
| gh | 2.40 以上，已登录，对目标仓库有 admin 权限 | 配置仓库、规则集、secret |
| jq | 1.6 以上 | 处理 JSON |
| curl | 任意 | 调 Multica 的状态接口 |
| multica | 0.5 以上 | 配置 Multica；brew install multica-ai/tap/multica，或装桌面端（自带 CLI） |
Windows 请在 WSL 里运行。
GitHub
Section titled “GitHub”- 目标仓库在 GitHub 上，你是 admin。
- 套餐决定平台闸门能做到什么程度，见保护等级。GitHub Free 的私有仓库没有规则集和自动合并，只能用降级模式。
- 推荐准备机器账号：至少 impl、review 两个（planner 可选），见机器账号和 token。没有就先用单账号试用模式。
Multica
Section titled “Multica”- 有一个工作区，运行
aiwf multica的人是 owner 或 admin（自定义状态只有他们能建）。 - 至少一台机器跑着 Multica daemon（桌面端会自动起；服务器上用
multica setup cloud或multica daemon start），机器上的 agent CLI（Claude Code、Codex、Copilot 等）已经登录对应的订阅账号。aiwf runtimes能列出在线的 runtime。 - 推荐三台机器（或三个隔离的环境）：A 跑 Implementer、B 跑 Reviewer、C 跑 Planner 和 Auditor，每台只登录对应的 GitHub 机器账号。
- agent 运行时要能访问仓库：daemon 会用机器上的 git 凭据克隆，确认那台机器能
git clone你的仓库。
这三件事 Multica 管不到，不做好，后面的编排全部白搭：
make check一条命令跑完全部检查；make dev一条命令起环境，可以重复执行；- 分层的 AGENTS.md，只写从代码里看不出来、或者容易搞错的规则。