🦞 三只虾协同体系 (Three Shrimp Collaboration)

版本： v1.0
创建： 2026-03-09
适用： OpenClaw 多 agent 协同场景

📋 概述

三只虾协同体系是一个多 agent 任务分配、执行、通知的完整框架，支持：

• ✅ 实时任务监控（fswatch，<1 秒触发）
• ✅ 自动心跳检查（工作时间 8:00-18:00）
• ✅ 任务完成自动通知
• ✅ 角色分工（CPMO/COO/CGO）

🎯 三只虾角色

🚀 快速开始

1. 安装依赖

# 安装 fswatch（文件监控）
brew install fswatch

2. 配置心跳监控

# 加载 launchd 配置
cp scripts/com.openclaw.heartbeat.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.openclaw.heartbeat.plist

# 加载 fswatch 监控
cp scripts/com.openclaw.fswatch.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.openclaw.fswatch.plist

3. 验证状态

# 检查心跳服务
launchctl list | grep openclaw.heartbeat

# 检查监控服务
launchctl list | grep openclaw.fswatch

# 查看日志
tail -f ~/Library/Logs/openclaw/heartbeat.log

📁 文件结构

skills/three-shrimp-collab/
├── SKILL.md                          # 本文件
├── README.md                         # 详细文档
├── scripts/
│   ├── heartbeat-check.sh            # 心跳检查脚本
│   ├── fswatch-monitor.sh            # 文件监控脚本
│   ├── notify-task-complete.sh       # 任务完成通知脚本
│   ├── setup-heartbeat.sh            # 一键配置脚本
│   ├── com.openclaw.heartbeat.plist  # 心跳 launchd 配置
│   └── com.openclaw.fswatch.plist    # 监控 launchd 配置
├── tasks/
│   └── queue.md                      # 任务队列
├── logs/
│   ├── heartbeat-*.log               # 心跳日志
│   └── fswatch-monitor.log           # 监控日志
└── docs/
    ├── 三只虾分工体系.md              # 角色分工
    ├── 三只虾协同协议.md              # 协同规范
    ├── 三只虾汇报模板.md              # 汇报格式
    └── 三只虾自动化流程.md            # 流程图

📝 核心功能

1. 任务分配

格式：

- [ ] [角色] 任务描述 - 分配人 @时间

示例：

- [ ] [CPMO] 整理项目周报 - 飞书虾统筹 @2026-03-09 14:00
- [ ] [CGO] 写一篇小红书教程 - 老板 @2026-03-09 15:00

2. 任务执行

终端虾（CPMO）流程：

1. 检测到新任务（fswatch 监控）
2. 领取任务（更新为 [~] 处理中）
3. 执行任务
4. 标记完成（更新为 [x] 已完成）

3. 任务通知

自动通知流程：

1. 心跳检测完成任务
2. 生成通知消息
3. 飞书虾发送飞书消息给老板

通知格式：

✅ 任务完成

📋 任务：[CPMO] 整理项目周报
🦞 执行者：终端虾（CPMO）
⏰ 完成时间：2026-03-09 14:30

【任务结果】
具体内容...

---
_任务已完成，请老板查阅_

🕐 心跳机制

工作时间

• 时间： 每天 8:00-18:00
• 频率： 每小时一次
• 触发： fswatch 实时监控（<1 秒）

检查层级

🔧 配置选项

环境变量

# 飞书通知配置
export FEISHU_WEBHOOK="https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
export FEISHU_USER_ID="ou_xxx"

# 工作时间配置
export WORK_START_HOUR=8
export WORK_END_HOUR=18

自定义心跳频率

编辑 scripts/com.openclaw.heartbeat.plist，修改 StartCalendarInterval 数组。

📊 监控和调试

查看服务状态

# 心跳服务
launchctl list | grep openclaw.heartbeat