{"skill":{"slug":"three-shrimp-collab","displayName":"三只虾协作系统","summary":"三只虾协作系统是基于多agent的任务分配、实时监控和自动通知框架，支持角色分工和心跳检测，实现任务高效协同。","description":"# 🦞 三只虾协同体系 (Three Shrimp Collaboration)\n\n**版本：** v1.0  \n**创建：** 2026-03-09  \n**适用：** OpenClaw 多 agent 协同场景\n\n---\n\n## 📋 概述\n\n三只虾协同体系是一个**多 agent 任务分配、执行、通知的完整框架**，支持：\n\n- ✅ 实时任务监控（fswatch，<1 秒触发）\n- ✅ 自动心跳检查（工作时间 8:00-18:00）\n- ✅ 任务完成自动通知\n- ✅ 角色分工（CPMO/COO/CGO）\n\n---\n\n## 🎯 三只虾角色\n\n| 角色 | 名字 | 职责 | Emoji |\n|------|------|------|-------|\n| **CPMO** | 终端虾（CPMO） | PMO 全权核心 | 🖥️ |\n| **COO** | 飞书虾（COO） | 统筹 + 协管 | 📱 |\n| **CGO** | Telegram 虾（CGO） | 副业全域执行 | 🌐 |\n\n---\n\n## 🚀 快速开始\n\n### 1. 安装依赖\n\n```bash\n# 安装 fswatch（文件监控）\nbrew install fswatch\n```\n\n### 2. 配置心跳监控\n\n```bash\n# 加载 launchd 配置\ncp scripts/com.openclaw.heartbeat.plist ~/Library/LaunchAgents/\nlaunchctl load ~/Library/LaunchAgents/com.openclaw.heartbeat.plist\n\n# 加载 fswatch 监控\ncp scripts/com.openclaw.fswatch.plist ~/Library/LaunchAgents/\nlaunchctl load ~/Library/LaunchAgents/com.openclaw.fswatch.plist\n```\n\n### 3. 验证状态\n\n```bash\n# 检查心跳服务\nlaunchctl list | grep openclaw.heartbeat\n\n# 检查监控服务\nlaunchctl list | grep openclaw.fswatch\n\n# 查看日志\ntail -f ~/Library/Logs/openclaw/heartbeat.log\n```\n\n---\n\n## 📁 文件结构\n\n```\nskills/three-shrimp-collab/\n├── SKILL.md                          # 本文件\n├── README.md                         # 详细文档\n├── scripts/\n│   ├── heartbeat-check.sh            # 心跳检查脚本\n│   ├── fswatch-monitor.sh            # 文件监控脚本\n│   ├── notify-task-complete.sh       # 任务完成通知脚本\n│   ├── setup-heartbeat.sh            # 一键配置脚本\n│   ├── com.openclaw.heartbeat.plist  # 心跳 launchd 配置\n│   └── com.openclaw.fswatch.plist    # 监控 launchd 配置\n├── tasks/\n│   └── queue.md                      # 任务队列\n├── logs/\n│   ├── heartbeat-*.log               # 心跳日志\n│   └── fswatch-monitor.log           # 监控日志\n└── docs/\n    ├── 三只虾分工体系.md              # 角色分工\n    ├── 三只虾协同协议.md              # 协同规范\n    ├── 三只虾汇报模板.md              # 汇报格式\n    └── 三只虾自动化流程.md            # 流程图\n```\n\n---\n\n## 📝 核心功能\n\n### 1. 任务分配\n\n**格式：**\n```markdown\n- [ ] [角色] 任务描述 - 分配人 @时间\n```\n\n**示例：**\n```markdown\n- [ ] [CPMO] 整理项目周报 - 飞书虾统筹 @2026-03-09 14:00\n- [ ] [CGO] 写一篇小红书教程 - 老板 @2026-03-09 15:00\n```\n\n### 2. 任务执行\n\n**终端虾（CPMO）流程：**\n1. 检测到新任务（fswatch 监控）\n2. 领取任务（更新为 `[~]` 处理中）\n3. 执行任务\n4. 标记完成（更新为 `[x]` 已完成）\n\n### 3. 任务通知\n\n**自动通知流程：**\n1. 心跳检测完成任务\n2. 生成通知消息\n3. 飞书虾发送飞书消息给老板\n\n**通知格式：**\n```\n✅ 任务完成\n\n📋 任务：[CPMO] 整理项目周报\n🦞 执行者：终端虾（CPMO）\n⏰ 完成时间：2026-03-09 14:30\n\n【任务结果】\n具体内容...\n\n---\n_任务已完成，请老板查阅_\n```\n\n---\n\n## 🕐 心跳机制\n\n### 工作时间\n- **时间：** 每天 8:00-18:00\n- **频率：** 每小时一次\n- **触发：** fswatch 实时监控（<1 秒）\n\n### 检查层级\n\n| 层级 | 频率 | 内容 |\n|------|------|------|\n| **Layer 1** | 每小时 | 快速检查任务队列 |\n| **Layer 2** | 每天 12:00 | 完整同步（读取所有文件） |\n| **Layer 3** | 每天 17:00 | 每日总结 |\n| **Layer 4** | 实时 | 任务完成通知 |\n\n---\n\n## 🔧 配置选项\n\n### 环境变量\n\n```bash\n# 飞书通知配置\nexport FEISHU_WEBHOOK=\"https://open.feishu.cn/open-apis/bot/v2/hook/xxx\"\nexport FEISHU_USER_ID=\"ou_xxx\"\n\n# 工作时间配置\nexport WORK_START_HOUR=8\nexport WORK_END_HOUR=18\n```\n\n### 自定义心跳频率\n\n编辑 `scripts/com.openclaw.heartbeat.plist`，修改 `StartCalendarInterval` 数组。\n\n---\n\n## 📊 监控和调试\n\n### 查看服务状态\n\n```bash\n# 心跳服务\nlaunchctl list | grep openclaw.heartbeat\n\n# 监控服务\nlaunchctl list | grep openclaw.fswatch\n```\n\n### 查看日志\n\n```bash\n# 心跳日志\ntail -f ~/Library/Logs/openclaw/heartbeat.log\n\n# 监控日志\ntail -f ~/Library/Logs/openclaw/fswatch-monitor.log\n\n# 任务通知日志\ntail -f ~/Library/Logs/openclaw/pending-notifications.log\n```\n\n### 手动测试\n\n```bash\n# 手动执行心跳检查\n./scripts/heartbeat-check.sh\n\n# 手动触发通知\n./scripts/notify-task-complete.sh \"任务名称\" \"执行者\" \"完成时间\" \"详情\"\n```\n\n---\n\n## 🎯 使用场景\n\n### 场景 1：老板分配任务\n\n```\n老板：飞书虾，给终端虾安排个活，整理下项目周报\n\n飞书虾：好的老板！\n✅ 已添加到任务队列\n✅ 监控已触发\n⏳ 等待终端虾执行\n```\n\n### 场景 2：任务自动通知\n\n```\n（终端虾完成任务后）\n飞书虾：📱 自动发送飞书消息\n\n✅ 任务完成\n📋 任务：项目周报整理\n🦞 执行者：终端虾\n⏰ 完成时间：2026-03-09 14:30\n📎 链接：https://feishu.cn/docx/xxx\n```\n\n### 场景 3：每小时进展简报\n\n```\n📊 三只虾进展简报（14:00）\n\n【任务状态】\n- [CPMO] 终端虾：编写项目周报（进行中 50%）\n- [COO] 飞书虾：统筹今日汇报（已完成）\n- [CGO] Telegram 虾：小红书文案（待处理）\n\n【统计】\n待处理：2 | 进行中：1 | 已完成：5\n```\n\n---\n\n## 🚨 常见问题\n\n### Q1: 任务监控不工作？\n**A:** 检查 fswatch 服务是否运行：\n```bash\nlaunchctl list | grep openclaw.fswatch\n```\n\n### Q2: 通知没收到？\n**A:** 检查 pending-notifications 文件：\n```bash\ncat logs/pending-notifications-*.md\n```\n\n### Q3: 心跳不执行？\n**A:** 检查是否在工作时间（8:00-18:00），脚本会自动跳过非工作时间\n\n### Q4: 如何临时关闭监控？\n**A:** \n```bash\nlaunchctl unload ~/Library/LaunchAgents/com.openclaw.fswatch.plist\n```\n\n---\n\n## 📚 相关文档\n\n- `三只虾分工体系.md` - 详细角色分工\n- `三只虾协同协议.md` - 协同规范\n- `三只虾汇报模板.md` - 汇报格式\n- `三只虾自动化流程.md` - 流程图\n- `HEARTBEAT.md` - 心跳配置\n\n---\n\n## 🎉 最佳实践\n\n1. **任务命名清晰** - 包含角色、内容、截止时间\n2. **及时更新状态** - 领取→处理中→完成\n3. **主动汇报进展** - 重要任务实时同步\n4. **定期清理任务** - 每日 17:00 清理旧任务\n\n---\n\n## 📝 更新日志\n\n### v1.0 (2026-03-09)\n- ✅ 初始版本\n- ✅ fswatch 实时监控\n- ✅ 心跳检查机制\n- ✅ 任务完成自动通知\n- ✅ 三只虾角色分工\n\n---\n\n_创建人：飞书虾（COO）_  \n_批准人：老板_  \n_最后更新：2026-03-09 16:23_\n","tags":{"agent":"1.0.0","automation":"1.0.0","collaboration":"1.0.0","latest":"1.0.0","pmo":"1.0.0"},"stats":{"comments":0,"downloads":693,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773544827619,"updatedAt":1778999913500},"latestVersion":{"version":"1.0.0","createdAt":1773544827619,"changelog":"初始版本：多 Agent 任务协同框架，支持实时任务监控（fswatch）、自动心跳检查（8:00-18:00）、任务完成自动通知。包含三只虾角色分工（CPMO/COO/CGO）、launchd 定时任务、飞书自动通知等核心功能。","license":"MIT-0"},"metadata":null,"owner":{"handle":"ayangai","userId":"s178a1snn59x5rjce50t9g2np183jxr0","displayName":"张洋","image":"https://avatars.githubusercontent.com/u/12815071?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089892322}}