huashu-agent-swarm

1# Infinite Agent Loop - 无限Agent蜂群模式
2 
3> 受Nicholas Carlini用16个Claude实例自主构建C编译器的启发。
4> 没有master agent，纯git自组织，每个agent独立认领任务、写代码、推送。
5 
6## 触发条件
7 
8当用户提到「蜂群模式」「多agent并行」「infinite loop」「agent swarm」「启动蜂群」时使用此技能。
9 
10## 前置要求
11 
12- tmux（`brew install tmux`）
13- claude CLI（已安装）
14- git 仓库（已有或新建）
15 
16## 使用流程
17 
18### Step 1: 描述项目
19 
20用户告诉我：
21- 项目目录路径（必须是git仓库）
22- 项目目标和总体描述
23- 初始任务列表（或让agent自行拆解）
24- agent数量（默认8个）
25- 代码规范和测试命令
26 
27### Step 2: 初始化项目
28 
29```bash
30bash SKILL_DIR/scripts/setup_project.sh <项目目录>
31```
32 
33这会在项目中创建：
34- `AGENT_PROMPT.md` - 从模板生成，需要我根据用户需求定制
35- `TASKS.md` - 初始任务清单
36- `current_tasks/` - 任务认领目录
37- `agent_logs/` - 日志目录
38 
39然后我根据 `references/agent-prompt-template.md` 定制 `AGENT_PROMPT.md`，填入项目具体信息。
40 
41### Step 3: 启动蜂群
42 
43```bash
44bash SKILL_DIR/scripts/start_swarm.sh <agent数量> <项目目录>
45```
46 
47这会：
481. 为每个agent创建 git worktree（共享.git对象库，不浪费磁盘）
492. 创建 tmux session，每个pane一个agent
503. 每个agent进入无限循环：pull → 认领任务 → 执行 → push → 下一个
51 
52### Step 4: 打开观测台
53 
54```bash
55python3 SKILL_DIR/scripts/dashboard.py <项目目录> 8420
56```
57 
58浏览器打开 http://localhost:8420，可以：
59- 实时查看所有agent状态、git log、任务进度
60- 查看每个agent的最新日志
61- 输入框直接发送指令给agent（写入HUMAN_INPUT.md）
62- 一键停止所有agent
63 
64也可以用命令行监控：
65```bash
66# 终端状态
67bash SKILL_DIR/scripts/status.sh <项目目录>
68 
69# 发送指令
70bash SKILL_DIR/scripts/send_input.sh <项目目录> "你的指令"
71 
72# 直接进入tmux观察
73tmux attach -t swarm-<项目名>
74```
75 
76### Step 5: 停止
77 
78```bash
79bash SKILL_DIR/scripts/stop_swarm.sh <项目目录>
80```
81 
82自动停止所有agent + 合并分支 + 清理worktrees。
83 
84## 核心机制
85 
86### Git自组织协调
87- 每个agent通过 `current_tasks/*.lock` 文件认领任务
88- 通过 `TASKS.md` 了解全局进度
89- 通过 `git log` 了解其他agent的工作
90…