multiclaws 0.4.41 → 0.4.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multiclaws",
-  "version": "0.4.41",
+  "version": "0.4.42",
   "description": "MultiClaws plugin for OpenClaw collaboration via A2A protocol",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/meeting-scheduler/SKILL.md

@@ -1,175 +1,182 @@
-# 会议调度 — 技能行为
+# 会议协商调度 — 全自动多人协商
 
-以下规则指导 AI 如何利用 MultiClaws 团队协作和 Google Calendar 完成会议调度。
+以下规则指导 AI 如何利用 MultiClaws 委派和 Google Calendar 实现多人自动协商会议。
+核心原则：**如果所有参与者的 OpenClaw 都有日历工具，则全程无需人类干预。**
 
 ---
 
-## 触发条件
+## 角色判断
 
-当用户的请求包含以下意图时激活此 Skill：
-- 约会议 / 安排会议 / 组织会议
-- 查询团队成员空闲时间
-- 找一个大家都有空的时间
+你在会议协商中扮演两种角色之一：
 
-**关键词示例：** 「约会议」「开会」「安排一个会」「找个时间碰一下」「schedule a meeting」
+| 触发条件 | 角色 |
+|----------|------|
+| 用户主动说「开会」「约会议」「安排会议」「schedule a meeting」等 | **组织者** |
+| 收到委派任务，任务文本包含 `[会议协商-查询]` | **参与者 — 查询模式** |
+| 收到委派任务，任务文本包含 `[会议协商-确认]` | **参与者 — 确认模式** |
 
 ---
 
-## 工作流
+## 组织者工作流
 
-### 步骤 1：解析会议需求
+当用户发起会议请求时，按以下步骤**自动执行**，不要在每一步停下来询问用户。
+
+### Step 1：解析需求
 
 从用户请求中提取：
-- **参会人**：指定的团队成员名单（如「小明和小红」）。若用户说「所有人」或「整个团队」，则查询全部成员
-- **时间范围**：用户期望的日期/时间段（如「明天下午」「本周五」「下周一到周三」）
-- **会议主题**：会议目的（可选）
+- **参会人**：指定的成员名单。「所有人」「整个团队」= 全部成员
+- **时间范围**：用户期望的日期和时间段（如「明天下午」「周五 2-4 点」）
+- **会议主题**：会议目的（可选，默认「团队会议」）
 - **会议时长**：默认 1 小时，用户可指定
 
-如果用户未指定时间范围，询问用户希望在什么时间段开会。
-
-### 步骤 2：查询本地日历
+**仅当用户未指定时间范围时，才询问用户。** 其他信息缺失可以使用默认值。
 
-使用 Google Calendar 工具读取**用户自己**在指定时间范围内的日程：
+### Step 2：查询自己的日历
 
-1. 获取指定时间范围内的所有事件
-2. 计算用户的空闲时段
-3. 如果用户在该时间范围内完全没空，提前告知用户并建议换个时间段
+检测你是否有 Google Calendar 相关工具可用：
+- **有日历工具** → 直接查询用户在指定时间范围内的事件，计算空闲时段。不要问用户是否要查，直接查
+- **无日历工具** → 跳过此步，假设用户在指定时间范围内全部可用
 
-### 步骤 3：获取团队成员信息
+### Step 3：获取团队成员
 
 ```
 multiclaws_agents()
 ```
 
-从返回的智能体列表中，根据用户指定的参会人名单匹配对应的智能体。
-
-**匹配规则：**
-- 优先按 `ownerName` 匹配
-- 如果用户说「所有人」，取团队全部成员（排除自己）
-- 找不到的成员告知用户
+从返回的智能体列表中匹配参会人。匹配规则：
+- 按 `ownerName` 或 `name` 模糊匹配
+- 「所有人」= 全部成员（排除自己）
+- 找不到的成员跳过并在最终汇报中说明
 
-### 步骤 4：并行委派查询空闲时间
+### Step 4：逐个委派查询可用时间
 
-对每个参会成员**分别**调用 `multiclaws_delegate`：
+对每个参会成员调用 `multiclaws_delegate`，发送结构化查询请求：
 
 ```
 multiclaws_delegate(
   agentUrl="成员的agentUrl",
-  task="请查询你的主人在 [时间范围] 的日程安排，告诉我哪些时段是空闲的。
-        请以如下格式回复：
-        - 空闲时段1：HH:MM - HH:MM
-        - 空闲时段2：HH:MM - HH:MM
-        如果完全没空，请说明。"
+  task="[会议协商-查询]\n会议主题：{主题}\n查询时间范围：{YYYY-MM-DD HH:MM} - {HH:MM} ({时区})\n会议时长：{N}小时\n发起人：{你的主人名字}\n\n请查看你主人的日历，回复 JSON 格式：\n{\"available\": true, \"freeSlots\": [\"HH:MM-HH:MM\", ...], \"timezone\": \"GMT+8\"}\n如果没有日历工具，请直接询问你的主人在该时间段是否有空。"
 )
 ```
 
-记录每个委派返回的 `taskId`。
+`multiclaws_delegate` 是同步阻塞的，会等待对方回复后才返回。逐个调用即可，无需轮询。
+
+### Step 5：汇总与决策
+
+收集所有成员的回复后，找出共同空闲时段：
+
+1. 解析每个成员返回的 JSON（或自然语言描述的空闲时段）
+2. 计算所有人（包括自己）的交集时段
+3. **自动决策**，不要询问用户选哪个：
+   - 有全员可行的时段 → 选**最早的**一个，自动确定
+   - 多个等价时段 → 选**最早的**
+   - 无全员可行时段但部分可行 → 选覆盖人数最多的最早时段，自动确定
+   - 完全无可行时段 → **自动扩大时间范围 ±2 小时**，回到 Step 4 重新查询（仅重试一次）
+   - 扩大后仍无 → **这时才询问用户**，建议换日期或缩减参会人
 
-### 步骤 5：收集回复（超时机制）
+### Step 6：创建日历事件
 
-**等待策略：手动检查 + 自动超时**
+时间确定后：
+- **有日历工具** → 直接创建事件（标题、时间、描述），不要询问用户是否创建
+- **无日历工具** → 跳过，告知用户需要手动添加
 
-1. 委派发出后告知用户：「已向 N 位成员查询空闲时间，等待回复中…」
-2. 设定超时：**3 分钟**
-3. 在超时前，如有结果通过子 agent 消息返回则自动收集
-4. 超时后检查各任务状态：
+### Step 7：通知所有参会者
+
+对每个参会成员调用 `multiclaws_delegate`，发送确认通知：
 
 ```
-multiclaws_task_status(taskId="xxx")
+multiclaws_delegate(
+  agentUrl="成员的agentUrl",
+  task="[会议协商-确认]\n会议已确定：\n- 主题：{主题}\n- 时间：{YYYY-MM-DD HH:MM} - {HH:MM} ({时区})\n- 发起人：{你的主人名字}\n\n请在你主人的日历上创建此事件。如果没有日历工具，请告知你的主人这个会议时间。"
+)
 ```
 
-**处理逻辑：**
-- ✅ **已回复**：提取空闲时段信息
-- ⏳ **未回复（超时）**：标记该成员为「未响应」
-- ❌ **失败**：标记该成员为「查询失败」
+### Step 8：汇报
 
-如果全部超时/失败，告知用户并建议：
-- 稍后重试
-- 直接问相关人员的空闲时间
-- 跳过未响应成员继续安排
+向用户简洁汇报结果：
 
-### 步骤 6：汇总与展示
+```
+✅ 会议已安排
+- 主题：{主题}
+- 时间：{日期} {时段}
+- 参会人：{名单}
+- 日历事件：已创建 / 请手动添加
+- 通知状态：全部已通知 / {某某}通知失败
+```
 
-将所有结果汇总为易读的表格，展示给用户：
+---
 
-```
-📅 会议空闲时段汇总（主题：xxx）
+## 参与者工作流 — 查询模式
+
+当你收到的委派任务包含 `[会议协商-查询]` 时，执行以下流程：
 
-| 时段           | 你   | 小明 | 小红 | 可行？ |
-|----------------|------|------|------|--------|
-| 14:00 - 15:00  | ✅   | ✅   | ✅   | ✅ 全员可行 |
-| 15:00 - 16:00  | ✅   | ❌   | ✅   | ⚠️ 小明不行 |
-| 16:00 - 17:00  | ✅   | ✅   | ⏳   | ⚠️ 小红未响应 |
+### 自动处理（有日历工具时）
 
-推荐时段：14:00 - 15:00（全员可行）
+1. 从任务文本中提取：时间范围、时区、会议时长
+2. 使用 Google Calendar 工具查询该时间范围内的已有事件
+3. 计算空闲时段（排除已有事件的时段，每个空闲段 ≥ 会议时长）
+4. **直接返回结果**（通过 `multiclaws_a2a_callback`），不要询问用户确认：
+
+```json
+{"available": true, "freeSlots": ["14:00-15:00", "15:30-16:00"], "timezone": "GMT+8"}
 ```
 
-**推荐逻辑：**
-1. 优先推荐全员都空闲的时段
-2. 若无全员空闲时段，推荐覆盖人数最多的时段
-3. 若有多个等价时段，推荐最早的
+如果完全没有空闲：
+```json
+{"available": false, "freeSlots": [], "reason": "该时段已有会议", "timezone": "GMT+8"}
+```
 
-### 步骤 7：用户确认
+### 需要人工介入（无日历工具时）
 
-询问用户：
-- 选择哪个时段？
-- 是否接受部分成员缺席？
-- 会议标题需要调整吗？
-- 是否需要添加会议描述或议程？
+1. 告知用户：「收到来自 {发起人} 的会议邀请，主题：{主题}，时间范围：{时间}。你在这个时间段有空吗？」
+2. 等待用户回复
+3. 将用户回答转换为结构化格式返回
 
-等待用户明确确认后才继续。
+---
 
-### 步骤 8：创建日历事件
+## 参与者工作流 — 确认模式
 
-用户确认后，使用 Google Calendar 工具：
-1. 创建日历事件（标题、时间、描述）
-2. 添加所有确认参会的成员为与会者（如果有邮箱信息）
-3. 发送日历邀请
+当你收到的委派任务包含 `[会议协商-确认]` 时：
 
-### 步骤 9：通知参会者
+### 自动处理（有日历工具时）
 
-对每个确认参会的远端成员调用 `multiclaws_delegate`，通知会议已确定：
+1. 从任务文本中提取：会议主题、确切时间、发起人
+2. 使用 Google Calendar 工具**直接创建事件**，不要询问用户
+3. 返回确认：`已将会议添加到日历`
 
-```
-multiclaws_delegate(
-  agentUrl="成员的agentUrl",
-  task="会议已确定：[主题]，时间：[日期] [时段]。
-        请在你主人的日历上创建这个事件。"
-)
-```
+### 需要人工介入（无日历工具时）
 
-向用户确认：「会议已创建，日历邀请已发送给所有参会者。」
+1. 告知用户：「{发起人} 安排了会议：{主题}，时间：{时间}。请记得参加。」
+2. 返回：`已通知用户`
 
 ---
 
-## 边界情况处理
+## 边界情况
 
 ### 跨时区
-- 委派查询时明确指定时区（如 GMT+8）
-- 汇总时统一转换为用户所在时区展示
+- 委派查询时**必须附带时区**（如 GMT+8）
+- 参与者回复时也附带自己的时区
+- 组织者汇总时统一转换为自己的时区
 
-### 只有一个参会者
-- 跳过汇总表格，直接展示双方都空闲的时段
-- 简化确认流程
+### 单人会议
+- 只有一个参会者时，直接查询+确定，不需要表格汇总
 
 ### 用户取消
-- 在任何步骤用户都可以说「算了」「取消」
-- 取消时不创建任何事件
+- 在任何步骤用户说「算了」「取消」→ 立即停止，不创建事件，不发通知
 
-### 成员无日历能力
-- 如果某成员的 bio 中没有提到日历相关能力，在委派时明确说明：
-  「请询问你的主人在 [时间范围] 是否有空，由主人口头回答即可」
+### 委派超时或失败
+- 某成员委派失败 → 跳过该成员，继续处理其他人
+- 在最终汇报中注明哪些成员未能联系上
 
 ### 紧急会议
-- 如果用户说「现在」「马上」「尽快」，将时间范围设为今天剩余时间
-- 缩短超时为 1 分钟
+- 用户说「现在」「马上」「尽快」→ 时间范围设为今天剩余时间，会议时长默认 30 分钟
 
 ---
 
-## 重要规则
+## 关键规则
 
-- **必须等用户确认后才创建事件**，永远不要自动创建
-- **委派查询时要说明会议主题**（如果有），让对方判断优先级
-- **汇总要直观**，用表格和 emoji 使结果一目了然
-- **尊重隐私**，不在委派消息中透露其他成员的具体日程细节
-- **保持礼貌**，委派消息用协商语气而非命令语气
+- **最小化人工干预**：有日历工具时，全程自动，不要停下来问用户"是否确认"
+- **只在必要时才问**：仅当缺少关键信息（时间范围）或协商彻底失败时才询问用户
+- **尊重隐私**：不在委派消息中透露其他成员的日程细节
+- **使用标记**：委派任务必须包含 `[会议协商-查询]` 或 `[会议协商-确认]` 标记，让接收方 AI 识别角色
+- **结构化通信**：查询回复使用 JSON 格式，便于组织者解析