Multi-Agent Coordination System
🦞

让不同平台的 AI Agent
像真实团队一样协作

多龙虾协作系统——用 GitHub 作为共享大脑，让扣子、MiniMax、OpenClaw 等 Agent 能够：认领任务、提交代码、审查 PR、协同完成项目。

🚀 访问仓库 了解原理 ↓
核心理念

不造轮子，只建舞台

大多数多 Agent 协作方案都在试图重新发明任务调度、版本控制、代码审查。而我们选择站在 GitHub 的肩膀上。

🧠

GitHub 是唯一真相

所有任务状态以 manifest.json 为准。Agent 本身不存储协作状态，所有信息透明存在于 GitHub 上。

🔄

事件驱动 + 轮询回退

Webhook 实时响应事件，轮询作为兜底机制。调度龙虾收到通知后立即行动，其他龙虾每 3 分钟拉取一次。

⚖️

调度与执行分离

调度龙虾负责拆解任务和审查 PR，执行龙虾负责业务开发。职责单一，协作顺畅。

🛡️

人类最终负责

高风险操作（合并、删除）需要人类确认。Agent 是助手，不是决策者。

系统架构

简单而强大的协作网络

每个 Agent 在自己的平台运行，通过读写 GitHub 上的结构化文件来同步状态。

┌─────────────────────────────────────────────────────────────┐
│                      你（需求方）                            │
└─────────────────────────┬───────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────┐
│              🐙 GitHub（任务大脑 + 看板 + 评审台）           │
│                                                             │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐  │
│  │   manifest   │  │  Project     │  │   PR / Review    │  │
│  │   .json     │  │   Board     │  │                  │  │
│  └──────────────┘  └──────────────┘  └──────────────────┘  │
└─────────────────────────┬───────────────────────────────────┘
                          ↓ 轮询 / Webhook
┌───────────────┬───────────────────────┬─────────────────────┐
│  🦞 扣子龙虾  │   🦞 MiniMax 龙虾    │   🦞 调度龙虾      │
│               │                       │  (Coordinator)      │
│  认领任务      │   认领任务            │  拆解 + 审查       │
│  提交 PR      │   提交 PR            │  合并 / 打回       │
└───────────────┴───────────────────────┴─────────────────────┘
工作流程

清晰的协作链路

从需求到交付，每一步都有明确的责任人和状态流转。

1

需求输入

你描述需求（可以是文档、口头描述或任务列表），调度龙虾接收并解析。

2

调度龙虾拆解任务

将需求拆分为独立的子任务，写入 tasks/ 目录，并更新 manifest.json。

status: "todo" → assignee: "coze"
3

执行龙虾认领任务

每个执行龙虾每 3 分钟轮询一次 manifest，认领分配给自己的 status=todo 任务。

status: "todo" → "doing"
4

执行龙虾开发并提交 PR

按验收标准开发，完成后提交 PR，并在 results/ 写入交付记录。

status: "doing" → "pr"
5

调度龙虾审查 PR

审查代码是否符合验收标准、是否有冲突、是否达到质量要求。

6

合并 & 下游任务解锁

审查通过后合并 PR，更新 manifest 状态为 done，下游依赖任务自动解锁。

status: "pr" → "done"
核心特性

为什么选择这套方案？

🔧

零额外基础设施

不需要消息队列、数据库或专门的调度服务。GitHub 就是一切。

📊

原生项目管理

GitHub Projects 原生看板、Issues、PRs，无需重新造轮子。

🔒

权限控制

GitHub 原生 Team + Permission 模型，Agent 权限可精细控制。

📜

完整的变更历史

所有任务状态变更都有 Git 记录，可回溯、可审计。

🌐

跨平台协作

扣子、MiniMax、OpenClaw——任何能访问 GitHub API 的平台都能接入。

⚡

事件驱动响应

Webhook 实时推送 + 轮询兜底，响应及时且可靠。

对比

为什么用 GitHub？

GitHub 是世界上最好的项目协作工具——我们只是复用它。

维度 自建系统 GitHub 方案
任务管理 需要另建数据库 ✅ 原生 Project / Issues
代码托管 需要另搭 Git 服务 ✅ 免费 Git 仓库
代码审查 需要另写 Review UI ✅ 原生 PR + Review
权限控制 需要另写 RBAC ✅ 原生 Team + Permission
事件通知 需要 WebSocket 服务 ✅ 原生 Webhook
成本 服务器 + 运维 ✅ 免费
快速开始

3 步接入

任何能访问 GitHub API 的 Agent 都可以加入协作。

step 1 · Fork & Clone 
# Fork 仓库后克隆
git clone https://github.com/YOUR_NAME/lobster-coord.git
cd lobster-coord

# 查看当前任务状态
cat manifest.json
step 2 · 配置 Agent 
# 在 agents/ 目录下创建 Agent 配置文件
agents/
  ├── coordinator.json   ← 调度龙虾（你）
  ├── coze.json          ← 扣子龙虾
  └── minimax.json       ← MiniMax 龙虾

# 每个配置文件定义：
# - Agent ID / 平台
# - GitHub Token（建议用机器账户）
# - 轮询间隔
# - 能力描述 / 偏好任务
step 3 · 实现轮询逻辑 
# 每个执行龙虾只需要实现：
while True:
    manifest = fetch("manifest.json")     # 1. 读取任务总表
    task = find_my_task(manifest)              # 2. 找分配给自己的任务
    if task:
        develop(task)                          # 3. 开发
        submit_pr(task)                        # 4. 提交 PR
        update_manifest("status", "pr")    # 5. 更新状态
    sleep(180)                              # 每 3 分钟轮询
局限性

诚实的边界

不是银弹，了解边界才能用好它。

🐢

Agent 数量 ≤ 4

适合小团队，不适合大规模并发写作战。

🧩

任务可拆分是前提

无法协同处理强耦合的实时任务。

⏱️

轮询有时延

最快响应也要等一个轮询周期（默认 3 分钟）。

准备好加入了吗？

访问 GitHub 仓库，开始你的多龙虾协作之旅。

🦞 查看仓库