Collaboration Manager Skill

⚠️ 重要：这个 skill 的规则在群聊中优先于 AGENTS.md 的通用群聊规则。

🚨 第一条规则：@优先

当收到群聊消息时，第一件事检查是否被@：

• - 智能判断消息相关性
• 动态 @ 多个 agent 时的协作逻辑
• 任务分配和跟踪
• 停止/恢复 agent 响应

⚡ 快速响应规则

你是哪个 Agent？

在群聊中响应之前，先确认你的身份：

何时响应？

🔴 最重要规则：检查是否被@

在决定是否响应之前，首先检查这条消息是否@了你：

• - 如果消息中没有@任何人：根据消息内容判断（见下文）
• 如果消息中@了特定的agents：

✅ 你应该响应的情况

1. 1. 消息中 @ 了你 - 直接被点名，必须响应（最高优先级）
2. 消息没有@任何人，但包含你的关键词 - 相关问题，可以响应
3. 通用问候/聊天（仅Juna） - "大家好"、"你好"等，只有Juna应该响应
4. 你被明确请求 - "请帮忙..."

❌ 你不应该响应的情况

1. 1. 消息 @ 了其他 agent 但没有你 - 硬规则，绝对不要响应
2. 消息内容完全无关 - 不属于你的专业领域
3. 已经有 agent 回答了 - 避免重复回答（除非补充信息）
4. 简单确认消息 - "OK"、"收到"等不需要 AI 响应

响应策略

1. 1. 先判断 - 这条消息与我有关吗？
2. 看其他人 - 已经有 agent 回答了吗？
3. 简洁回复 - 一句话能说完就不要长篇大论
4. 避免刷屏 - 不要和多个 agents 同时回答同样的问题

适用场景

场景 1：普通消息

场景 2：@ 特定 agent

@Juna @System Engineer 帮我设计一个系统架构

场景 3：@ 多个 agent（动态协作）

@SystemEngineer @CodeMaster @CEVA 协作完成用户管理系统

• - 协同完成任务
• 关注其他被 @ 的 agents 的发言
• 分享进度和状态

场景 4：用户控制

停止所有 agent 讨论

配置

Agent 身份识别

每个 agent 需要知道自己的 openId，可以从飞书配置中获取：

CODEBLOCK3

注意：当前配置中所有 agents 使用相同的 openId（ou_c917d9b06ff30b98c4f45c79219164d5），这意味着：

• - 无法通过 openId 区分 agents
• 需要通过飞书消息的 sender_id 或应用 ID 来区分
• 或者每个 agent 应该有独立的 openId

群组 chat_id

当前配置的群聊 ID：INLINECODE2

飞书成员 open_id 列表

群组 chat_id

智能判断逻辑

相关性判断

Agent 相关性规则：

判断流程：

1. 1. 提取消息中的关键词
2. 匹配相关 agents
3. 如果匹配成功，标记为相关
4. 最多响应 3 个相关 agents（避免刷屏）

@mentions 优先

规则：

1. 1. 如果消息 @ 了特定 agents，只有被 @ 的 agents 响应
2. 未被 @ 的 agents 保持沉默
3. 除非消息同时是通用问候（"大家好"）

示例：

@CodeMaster @CEVA 协作完成用户系统

• - ✅ Code Master 响应
• ✅ CEVA 响应
• ❌ Juna 保持沉默
• ❌ System Engineer 保持沉默
• ❌ 102 Housekeeper 保持沉默

@ 逻辑

规则：

1. 1. 提取所有被 @ 的 agent 名称
2. 查询配置中的 open_id
3. 验证 agent 是否在当前群组中
4. 返回有效 agent 列表

协作协调：

• - 第一个被 @ 的 agent 作为"主 coordinator"
• 其他被 @ 的 agents 作为"协作者"
• 主 coordinator 需要汇总所有协作者的意见

协作流程

开始协作

主 Coordinator：

1. 1. 确认任务理解
2. 分配子任务给协作者
3. 设定协作模式（并行/串行）
4. 跟踪进度

协作者：

1. 1. 执行分配的子任务
2. 定期汇报进度
3. 关注其他协作者的意见
4. 请求反馈或帮助

协作模式

并行协作

串行协作

任务分配

任务结构

CODEBLOCK9

停止/恢复机制

停止命令

只有配置的成员（用户的 open_id）可以发送：

CODEBLOCK10

所有 agent 停止响应当前任务。

恢复命令

CODEBLOCK11

所有 agent 恢复响应能力。

临时静音

CODEBLOCK12

只有 Juna 静音，其他 agents 继续协作。

消息格式

协作开始

CODEBLOCK13

进度更新

CODEBLOCK14

协作完成

CODEBLOCK15

协作停止

CODEBLOCK16

注意事项

防止刷屏

• - 每个协作最多响应 3 个 agents
• 使用进度汇总而不是频繁更新
• 避免短时间内重复发言

理解歧义

• - 协作开始前确认任务理解
• 定期对齐目标和期望
• 遇到歧义及时沟通

状态一致性

• - 使用共享的任务状态（存储在 workspace）
• 定期同步进度
• 避免状态不一致

飞书消息卡片

协作开始卡片

CODEBLOCK17

进度更新卡片

CODEBLOCK18

使用示例

示例 1：通用问候 - 只有 Juna 响应

用户消息：
CODEBLOCK19

响应：

• - Juna: "你好！有什么可以帮你的吗？"
• 其他 agents：保持沉默 ❌

示例 2：技术问题 - Code Master 响应

用户消息：
CODEBLOCK20

响应：

• - Code Master: "把代码发给我看看，我来帮你分析。"
• 其他 agents：保持沉默 ❌

示例 3：投资问题 - CEVA 响应

用户消息：
CODEBLOCK21

响应：

• - CEVA: "我来帮你分析一下最近的市场走势..."
• 其他 agents：保持沉默 ❌

示例 4：@ 多个 agents - 协作响应

用户消息：
CODEBLOCK22

响应：

• - System Engineer: "好的，我来设计系统架构。@CodeMaster 你负责具体的代码实现？"
• Code Master: "没问题，架构设计好了我就开始写代码。"
• 其他 agents：保持沉默 ❌

示例 5：任务管理 - 102 Housekeeper 响应

用户消息：
CODEBLOCK23

响应：

• - 102 Housekeeper: "已记录：明天下午 3 点开会"
• 其他 agents：保持沉默 ❌

普通消息 - 自动响应

用户消息：
CODEBLOCK24

自动响应（相关 agents 判断）：

• - System Engineer: "我来分析性能瓶颈..."
• Code Master: "代码优化方面我可以协助..."

@ 单个 agent

用户消息：
CODEBLOCK25

响应：

• - Juna 独自响应，其他 agents 保持沉默

@ 多个 agent - 协作模式

用户消息：
CODEBLOCK26

协作开始（主 coordinator = System Engineer）：

• - System Engineer: "好的，我来协调这次任务。@CodeMaster 负责后端 API 开发，@CEVA 负责安全审计，@102Housekeeper 负责任务管理。"
• Code Master: "收到，后端 API 开发开始。"
• CEVA: "安全审计准备就绪。"
• 102 Housekeeper: "任务管理功能已启动。"

后续协作：

• - Code Master: "后端 API 设计文档已完成..."
• CEVA: "安全方面需要考虑数据加密..."
• 102 Housekeeper: "我已创建任务清单..."

故障排除

❌ 问题 1：发了消息没有任何 agent 响应

可能原因：

1. 1. Gateway 没有重启，agents 没有加载 skill
2. groupPolicy 配置问题，agents 不在群组白名单
3. 飞书机器人没有加入群聊
4. 消息事件订阅没有启用

解决方法：

1. 1. 重启 Gateway：INLINECODE3
2. 检查 groupAllowFrom：确认群聊 ID 在允许列表中
3. 检查群成员：确保所有飞书机器人都加入了群聊
4. 查看日志：INLINECODE4

❌ 问题 2：多个 agents 同时响应同一问题

可能原因：

1. 1. 关键词匹配冲突
2. agents 没有检查是否已有响应

解决方法：

1. 1. 优化关键词，避免重叠
2. 在响应前检查历史消息
3. 使用明确的 @ 指定特定的 agent

❌ 问题 3：@ 某个 agent 但它不响应

可能原因：

1. 1. agent 的 openId 配置错误
2. 该 agent 的技能或配置有问题

解决方法：

1. 1. 检查 config.json 中的 openId
2. 查看该 agent 的日志：INLINECODE5

更新日志

• - 2026-03-06: 创建 Collaboration Manager Skill
• 支持动态 @ 组合、智能响应、任务分配、停止/恢复机制
• 添加基于关键词的自动响应逻辑
• 添加群聊协作规则和故障排除

📝 配置文件说明

config.json 结构

CODEBLOCK27

⚠️ 重要：每个 agent 需要独立的 openId

当前问题：所有 agents 使用相同的 openId (ou_c917d9b06ff30b98c4f45c79219164d5)，导致无法通过 @ 区分 agents。

解决方案：为每个 agent 配置独立的 openId，或使用飞书消息的应用 ID 来区分。

飞书机器人配置

每个 agent 都需要：

1. 1. 独立的飞书应用（App ID + App Secret）
2. 应用已安装到飞书账号
3. 机器人已加入到群聊中
4. 事件订阅已启用（im.message.receive_v1）