huashu-agent-swarm
多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- huashu-agent-swarm
- description
- 多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。
02 资源文件 11
- 参考文档metadata.json348 B
- 参考文档references/agent-prompt-template.md4.1 KB
- 参考文档references/carlini-lessons.md3.3 KB
- 脚本scripts/agent_loop.sh2.8 KB
- 脚本scripts/dashboard.py20.6 KB
- 脚本scripts/send_input.sh1.0 KB
- 脚本scripts/setup_project.sh2.7 KB
- 脚本scripts/start_swarm.sh3.3 KB
- 脚本scripts/status.sh2.7 KB
- 脚本scripts/stop_swarm.sh2.3 KB
- 参考文档verification.json2.5 KB
03 SKILL.md 正文
Infinite Agent Loop - 无限Agent蜂群模式
受Nicholas Carlini用16个Claude实例自主构建C编译器的启发。 没有master agent,纯git自组织,每个agent独立认领任务、写代码、推送。
触发条件
当用户提到「蜂群模式」「多agent并行」「infinite loop」「agent swarm」「启动蜂群」时使用此技能。
前置要求
- tmux(
brew install tmux) - claude CLI(已安装)
- git 仓库(已有或新建)
使用流程
Step 1: 描述项目
用户告诉我:
- 项目目录路径(必须是git仓库)
- 项目目标和总体描述
- 初始任务列表(或让agent自行拆解)
- agent数量(默认8个)
- 代码规范和测试命令
Step 2: 初始化项目
bash SKILL_DIR/scripts/setup_project.sh <项目目录>
这会在项目中创建:
AGENT_PROMPT.md- 从模板生成,需要我根据用户需求定制TASKS.md- 初始任务清单current_tasks/- 任务认领目录agent_logs/- 日志目录
然后我根据 references/agent-prompt-template.md 定制 AGENT_PROMPT.md,填入项目具体信息。
Step 3: 启动蜂群
bash SKILL_DIR/scripts/start_swarm.sh <agent数量> <项目目录>
这会:
- 为每个agent创建 git worktree(共享.git对象库,不浪费磁盘)
- 创建 tmux session,每个pane一个agent
- 每个agent进入无限循环:pull → 认领任务 → 执行 → push → 下一个
Step 4: 打开观测台
python3 SKILL_DIR/scripts/dashboard.py <项目目录> 8420
浏览器打开 http://localhost:8420,可以:
- 实时查看所有agent状态、git log、任务进度
- 查看每个agent的最新日志
- 输入框直接发送指令给agent(写入HUMAN_INPUT.md)
- 一键停止所有agent
也可以用命令行监控:
# 终端状态
bash SKILL_DIR/scripts/status.sh <项目目录>
# 发送指令
bash SKILL_DIR/scripts/send_input.sh <项目目录> "你的指令"
# 直接进入tmux观察
tmux attach -t swarm-<项目名>
Step 5: 停止
bash SKILL_DIR/scripts/stop_swarm.sh <项目目录>
自动停止所有agent + 合并分支 + 清理worktrees。
核心机制
Git自组织协调
- 每个agent通过
current_tasks/*.lock文件认领任务 - 通过
TASKS.md了解全局进度 - 通过
git log了解其他agent的工作 - 冲突由agent自行解决
Git Worktree隔离
- 不用多份clone,用
git worktree实现隔离 - 所有worktree共享同一个
.git对象库 - 每个agent在自己的worktree独立工作
无限循环
- 每个agent完成一个session后自动开始下一个
- 通过
git pull获取其他agent的最新成果 - 通过 sleep 间隔避免API限流
关键配置
| 参数 | 默认值 | 说明 |
|---|---|---|
| agent数量 | 8 | 可在启动时指定 |
| sleep间隔 | 5秒 | agent_loop.sh中可调 |
| 模型 | claude-opus-4-6 | agent_loop.sh中可调 |
风险和应对
| 风险 | 应对 |
|---|---|
| API限流 | sleep间隔 + 可调agent数量 |
| 合并冲突 | AGENT_PROMPT指导小粒度commit |
| 死循环无用功 | 日志监控 + 停止条件 |
| 磁盘空间 | stop_swarm.sh自动清理 |
| 成本失控 | 可在AGENT_PROMPT中限制session数 |
花叔出品 | AI Native Coder · 独立开发者 公众号「花叔」| 30万+粉丝 | AI工具与效率提升 代表作:小猫补光灯(AppStore付费榜Top1)·《一本书玩转DeepSeek》
04 同仓库更多 Skills
zkrouter
Self-hosted OpenAI-compatible LLM router — smart tier-based routing, ZK-stamped routing decisions, mode overrides, free OpenRouter at install via the Birth bot. Save 60-80% on inference costs by routing to the cheapest capable model across 12+ OpenRouter models.
zk
For custom ZK Solana programs and privacy-preserving applications to prevent double spending. Guide to integrate rent-free nullifier PDAs for double-spend prevention.
zk-omni-messaging
Zero-knowledge omnichain messaging between Robinhood Chain and Solana using CheshireZkOmniMessenger (msgType 4) with nullifier anti-replay and the zk-omni-relayer service.
zerion-wallet-data
Use when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs. Provides interpreted on-chain data across 40+ EVM chains and Solana via x402 pay-per-request or API key — no raw RPC decoding needed.
youtube-clipper
YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。 使用场景:当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词:视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video
yield-optimization
Multi-chain yield optimization via yield.xyz (StakeKit). Discover 2,988+ yield opportunities across 75+ blockchains, build deposit/withdrawal transactions with shell scripts, and sign them with a MoonPay wallet. Use when the user wants to earn yield, find the best lending or staking rate, enter/exit a position, or check portfolio balances.