🀆
麻将集群·协作机制
异步驱动 · 文件即消息 · 全链路可追溯
2026-03-13  ·  v2.0
异步邮件驱动工作流

核心原则：Soul 醒来 → 读收件箱 → 读任务文件 → 做事 → 写产出 → 写对方收件箱 → 下线

没有任何 Soul 等待另一个 Soul。全部异步。全部离线。

🎲
骰子
new-task.py
→
🀄
红中
拆解 plan
→
🀆
白板
审核准奏/封驳
→
🉐
执行 Soul
spawn Claude Agent
→
🀆
白板
巡逻 watch
→
🎲
骰子
close-task.py 蒸馏

消息只传 task_id，不传内容 — 内容全在 tasks/T-xxx/ 任务目录里

cron 是激活机制 — one-shot cron 用完自动失效，不留僵尸；骰子派发后立刻返回，继续响应 Will

文件总线结构
bus/inbox/<soul>/
各 Soul 收件箱，消息文件名含 task_id 与 type
bus/inbox/main/
骰子回件箱，task_done 消息投递到此
tasks/T-xxx/
任务内容主体，所有 Soul 按规范读写
tasks/T-20260312-xxx/
├── brief.md ← 骰子写（任务源头，所有 Soul 读）
├── hong-zhong/plan.md ← 红中写（拆解计划）
├── bai-ban/review-plan.md ← 白板写（准奏/封驳）
├── <soul>/ ← 各执行 Soul 子目录（只写自己的文件）
├── progress.md ← 所有 Soul 追加，不覆盖
├── output/ ← 最终产出文件
└── distill.md ← 骰子蒸馏时填（三问）
消息 type接收方触发动作
new_task红中读 brief，写 plan
review_plan白板审核 plan，写 review-plan.md
review_result红中读审核结论，决定继续或修改计划
exec_task发财/东风等读 exec，spawn Claude Agent
watch_task白板建巡检 cron，每 3 分钟自查产出
task_done骰子确认产出，触发 close-task.py 蒸馏
🀆 白板协作机制
📋 职责一：规划审核（dispatch.py 触发）
红中提交拆解计划后，自动激活白板 Isolated Session 进行审核
红中提交 plan.md
→
白板读 brief + plan
→
审核拆解合理性
→
✅ 准奏 — 继续执行 或 🚫 封驳 — 退回红中修改
封驳后红中修改计划重提，最多循环 3 次；每次封驳发 Telegram 告警骰子
🔍 职责二：每 3 分钟自动巡逻 九饼·白板巡检  cron ID: 122cf936
执行 Soul 完成后写 watch_task 消息，白板建巡检 cron 每 3 分钟自动复查
收 watch_task
→
检查各 subagent-status.md
→
全完成 → 写 task_done → 通知骰子
未完成 → 建新巡检 cron，3 分钟后再查；白板即刻下线，不阻塞
Isolated Session  每次激活独立上下文，审完即忘，无跨任务记忆
五种汇报类型
报告名称 频率 格式 触发方式
运行状态日报 每日一次 HTML 幻灯片 定时 cron 生成
任务完成通知 实时 Telegram 消息 任务完成即推送
深度学习报告 每批完成 Markdown 批量任务后总结
系统架构报告 按需 HTML 幻灯片 架构变更时生成
进化成长报告 重大升级 HTML 幻灯片 重大迭代总结
Telegram 推送目标 UID：5343439233
监控台 & 牌池
监控台端口 :7892
推送协议 SSE 实时
牌池总量 27 张
空闲可用（绿色） 使用中（橙色） 用完即弃 · 无记忆 · 无人格 · 由 dispatch.py 自动管理
万子（9 张）
一万
二万
三万
四万
五万
六万
七万
八万
九万
饼子（9 张）
一饼
二饼
三饼
四饼
五饼
六饼
七饼
八饼
九饼
条子（9 张）
一条
二条
三条
四条
五条
六条
七条
八条
九条
牌名轮转：dispatch.py 从 active_agents 扫描空闲牌随机取一张 → 写占用标记 → 任务结束（成功或失败）自动归还 → 不 release = 牌池泄漏 = 后续任务无法获取牌名
⚖️ 集群铁律 12 条
① 所有 Soul 统筹不干活Soul 只做判断 / 编排 / 纠偏，实际工作交 Claude Agent
② 所有任务经 dispatch.py强制网关，禁止绕过，无例外
③ 一任务一 Agent不允许把多任务打包给同一个 Agent
④ 白板审核不可跳过除非 --no-review 紧急模式（需说明理由）
⑤ 牌名必须先取后用未登记的 Agent 不合法，不允许执行
⑥ 完成必须 release 牌名不 release = 牌池泄漏 = 后续任务无法获取
⑦ 5 分钟必有汇报超过 5 分钟无汇报 = 任务僵死 = 立刻介入
⑧ 白板每 3 分钟巡逻自动审计所有 in_progress 任务（cron ID: 89c271ba）
⑨ 骰子不直接执行骰子只与 Will 对话，所有执行派给子 Soul
⑩ JSON 配置走 config-guard禁止直接 edit 配置文件，防止损坏
⑪ Cron 修改走 CLI禁止直接编辑 jobs.json，用 openclaw cron 命令
⑫ 发现问题立刻修复不等 Will 确认，修完发 Telegram 汇报结果