Agent skill

Huashu Agent Swarm

by alchaincyf in alchaincyf/huashu-skills

多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。

MITAuto-check passedAgent Workflows

Install Huashu Agent Swarm

skills CLI
$ npx skills add alchaincyf/huashu-skills --skill huashu-agent-swarm -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alchaincyf/huashu-skills huashu-agent-swarm --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alchaincyf/huashu-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/huashu-agent-swarm .claude/skills/huashu-agent-swarm && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
huashu-agent-swarm
GitHub stars
1.7k
Token cost
~576 tokens
SKILL.md length
150 words
Files
10 (incl. scripts, references)
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。

  • Works in 5 steps: 描述项目 → 初始化项目 → 启动蜂群 → …
  • Tasks that involve Multi-agent orchestration
  • SKILL.md covers 触发条件, 前置要求, 使用流程 and 核心机制, plus 2 more sections
  • Runs Shell and Python scripts from its folder; calls bash, git and python3

What it does

Huashu Agent Swarm is an agent skill from alchaincyf/huashu-skills. 多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `references/agent-prompt-template.md`, `references/carlini-lessons.md` and `scripts/agent_loop.sh`).

It sits in Agent Workflows, covering Multi-agent orchestration, Git worktrees and Git workflow. It works with Git and tmux. The repository describes itself as: 花叔全部开源 Agent Skills 总目录:16 旗舰 + 14 人物视角 + 22 内置共 52 个 skill,分层分类 + AI Agent 安装协议 + 机器可读 skills.json + 更新检查机制. The licence is MIT.

When your agent uses it

  • Tasks that involve Multi-agent orchestration
  • Tasks that involve Git worktrees
  • Tasks that involve Git workflow

Example prompts

  • “多agent”
  • “agent swarm”
  • “/huashu-agent-swarm”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 描述项目
  2. 初始化项目
  3. 启动蜂群
  4. 打开观测台
  5. 停止

What it can do on your machine

Read from SKILL.md and the folder at commit 2efea35. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 7 files in scripts/ (Shell and Python), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • git
    • python3
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Huashu Agent Swarm loads about 576 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 24 tokens; SKILL.md has 150 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~576
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from alchaincyf/huashu-skills at commit 2efea35, republished under its MIT licence (© alchaincyf). 150 words, ~576 tokens.

Download SKILL.mdSave it as .claude/skills/huashu-agent-swarm/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
huashu-agent-swarm
description
多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。

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
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
bash SKILL_DIR/scripts/start_swarm.sh <agent数量> <项目目录>

这会:

  1. 为每个agent创建 git worktree(共享.git对象库,不浪费磁盘)
  2. 创建 tmux session,每个pane一个agent
  3. 每个agent进入无限循环:pull → 认领任务 → 执行 → push → 下一个
Step 4: 打开观测台
bash
python3 SKILL_DIR/scripts/dashboard.py <项目目录> 8420

浏览器打开 http://localhost:8420,可以:

  • 实时查看所有agent状态、git log、任务进度
  • 查看每个agent的最新日志
  • 输入框直接发送指令给agent(写入HUMAN_INPUT.md)
  • 一键停止所有agent

也可以用命令行监控:

bash
# 终端状态
bash SKILL_DIR/scripts/status.sh <项目目录>

# 发送指令
bash SKILL_DIR/scripts/send_input.sh <项目目录> "你的指令"

# 直接进入tmux观察
tmux attach -t swarm-<项目名>
Step 5: 停止
bash
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-6agent_loop.sh中可调

风险和应对

风险应对
API限流sleep间隔 + 可调agent数量
合并冲突AGENT_PROMPT指导小粒度commit
死循环无用功日志监控 + 停止条件
磁盘空间stop_swarm.sh自动清理
成本失控可在AGENT_PROMPT中限制session数

花叔出品 | AI Native Coder · 独立开发者 公众号「花叔」| 30万+粉丝 | AI工具与效率提升 代表作:小猫补光灯(AppStore付费榜Top1)·《一本书玩转DeepSeek》

© alchaincyf, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (scripts, references) in huashu-agent-swarm of alchaincyf/huashu-skills.

  • SKILL.md
  • references/agent-prompt-template.md
  • references/carlini-lessons.md
  • scripts/agent_loop.sh
  • scripts/dashboard.py
  • scripts/send_input.sh
  • scripts/setup_project.sh
  • scripts/start_swarm.sh
  • scripts/status.sh
  • scripts/stop_swarm.sh

Open the folder on GitHubat commit 2efea35

Compare with similar skills

Huashu Agent Swarm next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Huashu Agent Swarm compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Huashu Agent Swarm this skillalchaincyf/huashu-skills1.7k—~576Automated safety check: PassMIT
Multi Agent Orchestrationcat-xierluo/legal-skills720—~6.6kAutomated safety check: PassMIT
Clawteamwin4r/ClawTeam-OpenClaw1.5k—~3.1kAutomated safety check: PassMIT
Agtx Task Sweepfynnfluegge/agtx1.7k—~1.7kAutomated safety check: PassApache-2.0
Project Session ManagerYeachan-Heo/oh-my-claudecode40k—~4kAutomated safety check: PassMIT
Polyphonyalinaqi/maggy707—~980Automated safety check: PassMIT

Similar skills

  • Multi Agent Orchestration

    cat-xierluo/legal-skills

    编排两个以上边界独立的本地 worker,使用 Orca Run/Task/Dispatch、独立 worktree/session 或 tmux 回退,由 PM 负责拆解、派发、巡检、429 停滞恢复、独立验收、PR 收口与临时资源清理;也用于用户明确要求“并行推进”“多个 worker”“PM 总控”“Wave Autopilot”或防止 PM…

    720 GitHub stars~6.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Clawteam

    win4r/ClawTeam-OpenClaw

    Multi-agent swarm orchestration. An agent skill from win4r/ClawTeam-OpenClaw.

    1.5k GitHub stars~3.1k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Agtx Task Sweep

    fynnfluegge/agtx

    Breaks a conversation's results into feature-level tasks and pushes them to the agtx kanban board, where each task gets its own worktree and agent session.

    1.7k GitHub stars~1.7k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed
  • Project Session Manager

    Yeachan-Heo/oh-my-claudecode

    Creates isolated git worktrees, with optional tmux sessions, for PR reviews, issue fixes and feature work across projects and repositories.

    40k GitHub stars~4k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Polyphony

    alinaqi/maggy

    Multi-agent orchestration with container-isolated workspaces — each agent session runs in its own Docker container with independent git branches

    707 GitHub stars~980 tokensUpdated 17 days ago
    DevelopmentAuto-check passed
  • ClawTeam Multi-Agent Swarm

    win4r/ClawTeam-OpenClaw

    Launches a swarm of specialist Hermes agents in git-worktree-isolated tmux windows with a kanban board and file-based inboxes, using built-in templates like hedge-fund and code-review.

    1.5k GitHub starsUsed in 1 repo~2.9k tokens
    Agent WorkflowsAuto-check passed

More from alchaincyf/huashu-skills

All 21 skills in this repo
  • Huashu Data Pro

    alchaincyf/huashu-skills

    数据分析与办公提效全能助手。覆盖数据处理、分析洞察、报告撰写、PPT制作、数据可视化的端到端工作流. An agent skill from alchaincyf/huashu-skills.

    1.7k GitHub stars~928 tokensUpdated 18 days ago
    Auto-check passed
  • Huashu Douyin Script

    alchaincyf/huashu-skills

    抖音爆款脚本创作工作流。从竞品视频拆解到脚本生成的完整流程:下载抖音视频→Gemini视频分析→爆款公式提炼→脚本+分镜生成→AI味审校。

    1.7k GitHub stars~1.7k tokensUpdated 18 days ago
    Auto-check passed
  • Huashu Wechat Image

    alchaincyf/huashu-skills

    为微信公众号文章生成高质量配图。支持封面图(2.35:1)、正文插图(16:9/4:3)、信息图。提供两条路径:AI生成(视觉创意型)和HTML渲染(文字精确型)。当用户提到"公众号配图"、"公众号封面"、"文章配图"、"正文插图"、"公众号图片"时使用此技能。

    1.7k GitHub stars~2.4k tokensUpdated 18 days ago
    Auto-check: notes
  • Huashu Xhs Image

    alchaincyf/huashu-skills

    为小红书笔记生成高质量配图。默认AI生成(Gemini),仅精确数据表格用HTML兜底。当用户提到"小红书配图"、"小红书封面"、"小红书图片"、"做张小红书图"、"笔记配图"时使用此技能。

    1.7k GitHub stars~1.5k tokensUpdated 18 days ago
    Auto-check: notes
  • Huashu Slides

    alchaincyf/huashu-skills

    从内容到成品PPTX的端到端演示文稿制作,含AI插画生成和18种设计风格。当用户提到"做PPT"、"做幻灯片"、"演示文稿"、"Keynote"、"slides"时使用。

    1.7k GitHub stars~7.2k tokensUpdated 18 days ago
    Auto-check: notes
  • Huashu Md To PDF

    alchaincyf/huashu-skills

    将 Markdown 文档转换为专业的 PDF 白皮书,采用苹果设计风格. An agent skill from alchaincyf/huashu-skills.

    1.7k GitHub stars~824 tokensUpdated 18 days ago
    Auto-check passed

Works with

Categories

Questions about Huashu Agent Swarm

What does Huashu Agent Swarm do?

多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。. Huashu Agent Swarm is an agent skill from alchaincyf/huashu-skills.

When should I use Huashu Agent Swarm?

Huashu Agent Swarm fits situations like: tasks that involve Multi-agent orchestration; tasks that involve Git worktrees; tasks that involve Git workflow.

How do I install Huashu Agent Swarm in Claude Code?

Run `npx skills add alchaincyf/huashu-skills --skill huashu-agent-swarm -a claude-code`. Or copy the skill folder (huashu-agent-swarm in alchaincyf/huashu-skills) into .claude/skills/huashu-agent-swarm in your project. Claude Code loads it when a task matches its description.

How do I install Huashu Agent Swarm in Codex?

Run `npx skills add alchaincyf/huashu-skills --skill huashu-agent-swarm -a codex`. Or copy the skill folder (huashu-agent-swarm in alchaincyf/huashu-skills) into .agents/skills/huashu-agent-swarm in your project. Codex loads it when a task matches its description.

Can I use Huashu Agent Swarm in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alchaincyf/huashu-skills --skill huashu-agent-swarm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/huashu-agent-swarm, .gemini/skills/huashu-agent-swarm, .github/skills/huashu-agent-swarm and .opencode/skills/huashu-agent-swarm in your project.

What does Huashu Agent Swarm need to run?

Going by SKILL.md and its folder, Huashu Agent Swarm needs a shell and Python for the scripts in its folder and the command-line tools its instructions call (bash, git, python3 and brew). Our summary lists: Python 3; A Bash shell.

Does Huashu Agent Swarm access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Huashu Agent Swarm safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Huashu Agent Swarm use?

Huashu Agent Swarm is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Huashu Agent Swarm use?

About 576 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.9k tokens, read only when the agent opens those files.

What are the alternatives to Huashu Agent Swarm?

Skills that share tags, products or a category with Huashu Agent Swarm: Multi Agent Orchestration (cat-xierluo/legal-skills, 720 stars), Clawteam (win4r/ClawTeam-OpenClaw, 1.5k stars), Agtx Task Sweep (fynnfluegge/agtx, 1.7k stars) and Project Session Manager (Yeachan-Heo/oh-my-claudecode, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Huashu Agent Swarm?

alchaincyf (a GitHub user) maintains it in alchaincyf/huashu-skills, which has 1,695 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on September 22, 2026.

Source: alchaincyf/huashu-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.