小黄人通信
受RPG突袭机制启发的多代理协调服务器。建立在 主控程序 （模型上下文协议）——任何使用MCP的AI工具都可以加入突袭：Claude Code、Codex CLI、OpenCode、Gemini或其他任何工具。
这是什么？
AI代理具有有限的上下文窗口。当多个代理在同一个代码库上工作时，他们需要协调——谁在做什么，尝试了什么，陷阱在哪里，以及何时有人即将死亡（失去上下文）。
Minion Comms将多智能体工程视为RPG突袭。代码库是老板。特工是突袭队。上下文与HP相反——你一开始就充满活力，每一个动作都让你精疲力竭。
如果你曾经在魔兽世界中突袭过或在FF中被抹去过，你已经得到了这个
上下文窗口是HP栏。战斗进行到一半时，压实队变得头晕目眩。一个程序员在探索错误的文件时，就像DPS在垃圾桶上发起攻击。一个没有读过最新情报的预言家是一个有着陈旧习惯的治疗者。当领先优势下降时，这是一次突袭行动——没有人能了解全貌。
这不是事后强加的比喻。这些问题都是同样的问题：
- 党的组成很重要。 一个支持oracle的高级程序员>三个程序员独自探索。与一个戴齿轮的DPS相同，有一个专门的治疗师>三个戴耳朵的DPS拉脸。
- 你不能装傻。 对任务的高度依赖意味着错误的方法——对冰老板施加冰魔法。后退，重新评估，改变角度。
- 没有捡起来的战利品就是浪费。 当上下文窗口填满时，代理的未写下的发现就会消失。未共享的XP将丢失。
- 突袭队长的工作是对抗熵。 知识想和代理人一起死去。Lead的工作是确保它不会。
受...启发
- 魔兽世界 --突袭组成、坦克/DPS/治疗者角色、增益覆盖、攻击管理、区域分配、突袭领导者协调
- 最终幻想 —
fenix_down（凤凰坠落）为语境消亡后的复兴，党的阶级制度 - 马略拉的面具 —
moon_crash紧急停机（月亮正在落下，每个人都倾倒并逃跑） - Dead Drop团队 --该系统的v1版本。使用基于角色的代理传递SQLite消息。Minion Comms是一种进化。
- Vercel/Next.js --文件系统作为约定文件的数据库模式
- 军事通信 --简洁代码、CC纪律、指挥链
核心概念
5类
| 类 | 原型 | 他们做什么 |
|---|---|---|
lead | 指挥官 | 协调、安排任务、管理HP工具栏 |
coder | DPS | 编辑代码——唯一更改源代码的类 |
builder | Tank | 运行命令--构建、测试、部署。无编辑 |
oracle | Sage | 掌握区域知识，回答问题。无编辑，无命令 |
recon | Scout | 调查外部情报——网络、其他仓库、生态系统。报告返回 |
类=能力（永久）。角色=分配（运行时）。分配给音频区域的预言机变为 oracle-audio.
两个数据库
| 数据库 | 存储 | 示例 |
|---|---|---|
SQLite (messages.db) | 协调状态 | 代理、消息、任务元数据、文件声明、作战计划 |
文件系统 (.dead-drop/) | 知识 | 情报、陷阱、区域注释、任务规格、特工战利品 |
SQLite轨迹 *状态*.文件系统存储 *知识*.COMS显示文件位置，代理读取文件。
执法理念
Comms强制执行其拥有的东西（DB状态）。提醒它无法验证的内容（战斗时间行为）。
强迫： 收件箱规则、上下文新鲜度、文件声明、任务依赖关系、类限制、结果文件、作战计划要求
提醒： poll.sh运行，代理读取文件，遵循规范，HP真实性
角色继承
user (the human)
└── general (puppet — relays user intent)
└── commander (runs the fight — needs brains)
└── zone-lead (owns a section)
└── party (oracle, coder, builder, recon)关键力学
- 惠普 --上下文与HP相反。通过以下方式跟踪
set_context.Lead监控所有酒吧。 - Fenix Down --在上下文死亡之前将知识转储到磁盘。回来干净。
- 月球撞击 --紧急停机。每个人现在都击溃自己。
- 触发词 --简洁的代码（情景喜剧、拉力赛、撤退、热区）可以节省双方的生命值。
- 活动计数 --每次任务更新时自动递增。高计数=错误的方法。
- 提交索赔 --防止友军开火。无法编辑其他代理持有的文件。
- 英特尔/陷阱 --文件系统中已确认的发现和已知的危害。Oracle必须阅读它们。
- 战斗之旅 --在任务结束之前，代理人必须把他们学到的东西写下来。
交通：混合动力终端+无头
代理通过同一通信网络上的两种传输模式进行连接：
| 传输 | 代理类型 | 消息传递 |
|---|---|---|
terminal | 人类打开Claude Code命令行界面 | poll.sh 投票收件箱 |
daemon | 仆从群 生成无头 | Swarm守护进程监视数据库，在唤醒时注入 |
人类为他们想要关注的高价值代理打开终端。廉价的工作流向了群体守护进程。所有同行都在同一个通信系统中——相同的执法，相同的突袭日志。
工具（36）
| 阶段 | 工具 |
|---|---|
| 核心通信 | register, deregister, rename, set_status, set_context, who, send, check_inbox, get_history, purge_inbox |
| 作战室 | set_battle_plan, get_battle_plan, update_battle_plan_status, log_raid, get_raid_log |
| 任务系统 | create_task, assign_task, update_task, get_tasks, get_task, submit_result, close_task |
| 文件安全 | claim_file, release_file, get_claims |
| 监控 | party_status, check_activity, check_freshness |
| 生命周期 | cold_start, fenix_down, debrief, end_session |
| 触发词 | get_triggers, clear_moon_crash |
安装
curl -sSL https://raw.githubusercontent.com/ai-janitor/minion-comms/main/scripts/install.sh | bash这将通过pipx安装仆从通信，并将入职文档部署到 ~/.minion-comms/，并为Claude Code配置MCP。
或直接安装：
pipx install git+https://github.com/ai-janitor/minion-comms.git快速开始
# Run MCP server (stdio transport)
minion-comms
# Or add to your .mcp.json
{
"mcpServers": {
"minion-comms": {
"command": "minion-comms"
}
}
}状态
服务器实施完成（阶段0-8）。包括单行安装、入职文档和MCP自动配置。
看 docs/FRAMEWORK.md 以获取完整的设计规范。 看 PLAN.md 实施路线图。
世系
v1： 空投队 --基本消息传递+任务跟踪
v2： 小型通信 --RPG风格的课程协调、HP管理、知识持久性、执行理念和触发词