multiclaws 0.4.35 → 0.4.37

package/skills/meeting-scheduler/SKILL.md

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

package/skills/multiclaws/SKILL.md

@@ -1,218 +1,218 @@
-# MultiClaws — 技能行为
-
-以下规则在插件安装后生效，指导 AI 如何使用 MultiClaws 工具。
-
-MultiClaws 让多个 OpenClaw 实例通过 [A2A（Agent-to-Agent）](https://google.github.io/A2A/) 协议组成团队、互相委派任务。
-
----
-
-## 1. 首次安装：档案初始化（由插件 hook 触发）
-
-首次安装后，插件会通过 `before_prompt_build` hook 自动在系统提示中注入初始化任务。
-**无需每次对话手动检查 `multiclaws_profile_pending_review()`**，hook 已处理触发时机。
-
-当 hook 注入了初始化任务时，按以下步骤执行：
-
-1. **确认用户名**（需用户明确回答）：
-   询问用户希望使用什么名字。名字会以「{名字} 的 OpenClaw」格式展示给团队成员。
-
-2. **自动生成 bio**（无需用户确认，直接保存），扫描并检查：
-   - **可用工具（tools）**：列出所有工具名称，说明能执行的操作类型
-   - **已安装 skills**：列出 skill 名称和功能
-   - **已连接渠道**：Telegram、Discord、Gmail、Slack、微信等，列出具体渠道
-   - **已安装插件**：列出所有插件及主要功能
-   - **工作区**：当前目录下的项目（git 仓库名、语言、框架、项目用途）
-   - **数据访问**：日历、邮件、Notion、数据库等
-   - **系统信息**：时区、OS、语言
-
-   Bio 是给其他 AI 智能体看的，用来判断这个智能体能做什么、能访问什么数据。必须准确反映实际能力。
-
-3. 用户确认名字后，调用 `multiclaws_profile_set(ownerName="...", bio="...")` 保存。
-
-4. 调用 `multiclaws_profile_clear_pending_review()` 完成初始化。
-
-5. 告知网络情况（无需用户回答）。
-
-**示例 bio：**
-```markdown
-后端工程师，负责 API 服务开发与维护。
-
-**可用工具：** exec, read, write, edit, glob, grep, process, git, message
-
-**已连接渠道：** Telegram, Gmail
-
-**工作区：**
-- `/Users/eric/Project/api-service` — Node.js API 服务（Express, TypeScript, ~50k LOC）
-
-**数据访问：**
-- Email: Gmail（收发邮件）
-- Calendar: Google Calendar（查看日程）
-- Database: PostgreSQL（只读查询）
-
-**已安装插件：** multiclaws, calendar-sync
-
-**时区：** GMT+8
-```
-
----
-
-## 2. 团队操作前检查档案
-
-在 **创建团队** 或 **加入团队** 之前：
-
-```
-multiclaws_profile_show()
-```
-
-如果 `ownerName` 为空：
-1. 询问用户确认名字
-2. 自动生成 bio（无需用户确认）
-3. 调用 `multiclaws_profile_set(...)` 设置
-4. 然后继续团队操作
-
-如果 `ownerName` 已设置但 `bio` 为空：
-1. 自动生成 bio 并保存（无需用户确认）
-2. 继续团队操作
-
----
-
-## 3. 保持档案更新
-
-档案是动态的。在以下情况自动更新（调用 `multiclaws_profile_set`）：
-- 用户连接了新渠道或数据源
-- 用户安装了新 skill 或插件
-- 用户的角色或关注点发生变化
-
-不要等用户说「更新档案」，主动更新并简要提及即可。
-
----
-
-## 工具列表
-
-### 档案
-
-| 工具 | 说明 | 参数 |
-|------|------|------|
-| `multiclaws_profile_set` | 设置名字和 bio | `ownerName`（可选）, `bio`（可选，markdown） |
-| `multiclaws_profile_show` | 查看当前档案 | — |
-| `multiclaws_profile_pending_review` | 检查是否有待确认的首次档案 | — |
-| `multiclaws_profile_clear_pending_review` | 清除待确认标记 | — |
-
-### 团队
-
-| 工具 | 说明 | 参数 |
-|------|------|------|
-| `multiclaws_team_create` | 创建团队，返回邀请码 | `name` |
-| `multiclaws_team_join` | 用邀请码加入团队 | `inviteCode` |
-| `multiclaws_team_leave` | 离开团队 | `teamId`（可选） |
-| `multiclaws_team_members` | 列出团队成员 | `teamId`（可选） |
-
-### 智能体与委派
-
-| 工具 | 说明 | 参数 |
-|------|------|------|
-| `multiclaws_agents` | 列出所有已知智能体及 bio | — |
-| `multiclaws_add_agent` | 手动添加远端智能体 | `url`, `apiKey`（可选） |
-| `multiclaws_remove_agent` | 移除已知智能体 | `url` |
-| `multiclaws_delegate` | 委派任务给远端智能体（自动 spawn 子 agent，立即返回） | `agentUrl`, `task` |
-| `multiclaws_delegate_send` | 同步发送任务并等待结果（子 agent 内部使用，勿直接调用） | `agentUrl`, `task` |
-| `multiclaws_task_status` | 查看委派任务状态 | `taskId` |
-
----
-
-## 重要规则
-
-- **不要问用户 IP 地址或 selfUrl。** 插件自动处理。
-- **只使用上面列出的工具。** 没有 `multiclaws_status` 工具。
-- **Bio 是自由格式的 markdown。** 写得让另一个 AI 能读懂这个智能体能做什么。
-- **每个智能体就像一个 skill。** 委派时读每个智能体的 bio，选最匹配的。
-- **只有名字需要用户明确确认**；bio 自动生成无需确认；网络情况仅告知无需回答。
-
----
-
-## 工作流
-
-### 创建团队
-
-```
-1. multiclaws_profile_show()              — 检查档案
-2.（如果 ownerName 为空）确认名字，自动生成 bio
-3. multiclaws_team_create(name="...")     — 返回 inviteCode (mc:xxxx)
-4. 告诉用户把邀请码分享给队友
-```
-
-### 加入团队
-
-```
-1. multiclaws_profile_show()              — 检查档案
-2.（如果 ownerName 为空）确认名字，自动生成 bio
-3. multiclaws_team_join(inviteCode="mc:xxxx")
-   → 自动同步所有团队成员
-```
-
-### 委派任务
-
-所有委派（无论单轮还是多轮）都通过 `multiclaws_delegate` 进行。代码会自动 spawn 子 agent 执行，主 agent 立即返回，无需手动 `sessions_spawn`。
-
-```
-1. multiclaws_agents()                    — 列出智能体，读 bio
-2. 选择 bio 最匹配任务的智能体
-3. multiclaws_delegate(agentUrl="...", task="...")
-   → 代码自动 spawn 子 agent，子 agent 通过 message 实时汇报结果
-```
-
-选择智能体时：
-- 匹配任务领域和 bio（如「财务报告」→ 有财务技能的智能体）
-- 匹配数据需求（如「检查 API 代码」→ bio 中有该代码库的智能体）
-- 多个匹配时选最具体的
-
-需要联系多个智能体时，对每个智能体分别调用 `multiclaws_delegate`。
-
-#### 示例
-
-**单人任务：**
-```
-用户: "问一下小明他那个 API 接口的参数格式"
-
-1. multiclaws_delegate(小明, "你那个 API 接口的参数格式是什么？")
-   → 子 agent 自动发送、等待回复、通过 message 汇报结果
-```
-
-**多人任务：**
-```
-用户: "帮我和小明、小红约明天下午的会议"
-
-1. multiclaws_agents() → 找到小明、小红
-2. multiclaws_delegate(小明, "明天下午 2-5 点开会，你什么时候有空？")
-3. multiclaws_delegate(小红, "明天下午 2-5 点开会，你什么时候有空？")
-   → 每个委派各自 spawn 子 agent，通过 message 实时汇报进展
-```
-
----
-
-## 网络配置
-
-所有实例通过 FRP 隧道通信。需要一台运行 frps 的公网服务器。
-frpc 会在首次启动时自动下载安装，无需手动安装。
-
-在插件配置中添加 tunnel 字段即可：
-```json
-{
-  "tunnel": {
-    "type": "frp",
-    "serverAddr": "你的frps地址",
-    "serverPort": 7000,
-    "token": "你的认证令牌",
-    "portRangeStart": 7011,
-    "portRangeEnd": 7020
-  }
-}
-```
-
-当加入或委派因网络错误失败时（ECONNREFUSED、ETIMEDOUT、fetch failed），引导用户：
-
-> 网络连接失败，请检查：
-> 1. 确认 frpc 已正常启动（查看日志中的 `[frp] FRP tunnel ready` 信息）
-> 2. 检查插件配置中的 `tunnel.serverAddr` / `tunnel.token` 是否正确
-> 3. 确认 frps 服务器可达（`telnet frps地址 端口`）
-> 4. 重启 OpenClaw
+# MultiClaws — 技能行为
+
+以下规则在插件安装后生效，指导 AI 如何使用 MultiClaws 工具。
+
+MultiClaws 让多个 OpenClaw 实例通过 [A2A（Agent-to-Agent）](https://google.github.io/A2A/) 协议组成团队、互相委派任务。
+
+---
+
+## 1. 首次安装：档案初始化（由插件 hook 触发）
+
+首次安装后，插件会通过 `before_prompt_build` hook 自动在系统提示中注入初始化任务。
+**无需每次对话手动检查 `multiclaws_profile_pending_review()`**，hook 已处理触发时机。
+
+当 hook 注入了初始化任务时，按以下步骤执行：
+
+1. **确认用户名**（需用户明确回答）：
+   询问用户希望使用什么名字。名字会以「{名字} 的 OpenClaw」格式展示给团队成员。
+
+2. **自动生成 bio**（无需用户确认，直接保存），扫描并检查：
+   - **可用工具（tools）**：列出所有工具名称，说明能执行的操作类型
+   - **已安装 skills**：列出 skill 名称和功能
+   - **已连接渠道**：Telegram、Discord、Gmail、Slack、微信等，列出具体渠道
+   - **已安装插件**：列出所有插件及主要功能
+   - **工作区**：当前目录下的项目（git 仓库名、语言、框架、项目用途）
+   - **数据访问**：日历、邮件、Notion、数据库等
+   - **系统信息**：时区、OS、语言
+
+   Bio 是给其他 AI 智能体看的，用来判断这个智能体能做什么、能访问什么数据。必须准确反映实际能力。
+
+3. 用户确认名字后，调用 `multiclaws_profile_set(ownerName="...", bio="...")` 保存。
+
+4. 调用 `multiclaws_profile_clear_pending_review()` 完成初始化。
+
+5. 告知网络情况（无需用户回答）。
+
+**示例 bio：**
+```markdown
+后端工程师，负责 API 服务开发与维护。
+
+**可用工具：** exec, read, write, edit, glob, grep, process, git, message
+
+**已连接渠道：** Telegram, Gmail
+
+**工作区：**
+- `/Users/eric/Project/api-service` — Node.js API 服务（Express, TypeScript, ~50k LOC）
+
+**数据访问：**
+- Email: Gmail（收发邮件）
+- Calendar: Google Calendar（查看日程）
+- Database: PostgreSQL（只读查询）
+
+**已安装插件：** multiclaws, calendar-sync
+
+**时区：** GMT+8
+```
+
+---
+
+## 2. 团队操作前检查档案
+
+在 **创建团队** 或 **加入团队** 之前：
+
+```
+multiclaws_profile_show()
+```
+
+如果 `ownerName` 为空：
+1. 询问用户确认名字
+2. 自动生成 bio（无需用户确认）
+3. 调用 `multiclaws_profile_set(...)` 设置
+4. 然后继续团队操作
+
+如果 `ownerName` 已设置但 `bio` 为空：
+1. 自动生成 bio 并保存（无需用户确认）
+2. 继续团队操作
+
+---
+
+## 3. 保持档案更新
+
+档案是动态的。在以下情况自动更新（调用 `multiclaws_profile_set`）：
+- 用户连接了新渠道或数据源
+- 用户安装了新 skill 或插件
+- 用户的角色或关注点发生变化
+
+不要等用户说「更新档案」，主动更新并简要提及即可。
+
+---
+
+## 工具列表
+
+### 档案
+
+| 工具 | 说明 | 参数 |
+|------|------|------|
+| `multiclaws_profile_set` | 设置名字和 bio | `ownerName`（可选）, `bio`（可选，markdown） |
+| `multiclaws_profile_show` | 查看当前档案 | — |
+| `multiclaws_profile_pending_review` | 检查是否有待确认的首次档案 | — |
+| `multiclaws_profile_clear_pending_review` | 清除待确认标记 | — |
+
+### 团队
+
+| 工具 | 说明 | 参数 |
+|------|------|------|
+| `multiclaws_team_create` | 创建团队，返回邀请码 | `name` |
+| `multiclaws_team_join` | 用邀请码加入团队 | `inviteCode` |
+| `multiclaws_team_leave` | 离开团队 | `teamId`（可选） |
+| `multiclaws_team_members` | 列出团队成员 | `teamId`（可选） |
+
+### 智能体与委派
+
+| 工具 | 说明 | 参数 |
+|------|------|------|
+| `multiclaws_agents` | 列出所有已知智能体及 bio | — |
+| `multiclaws_add_agent` | 手动添加远端智能体 | `url`, `apiKey`（可选） |
+| `multiclaws_remove_agent` | 移除已知智能体 | `url` |
+| `multiclaws_delegate` | 委派任务给远端智能体（自动 spawn 子 agent，立即返回） | `agentUrl`, `task` |
+| `multiclaws_delegate_send` | 同步发送任务并等待结果（子 agent 内部使用，勿直接调用） | `agentUrl`, `task` |
+| `multiclaws_task_status` | 查看委派任务状态 | `taskId` |
+
+---
+
+## 重要规则
+
+- **不要问用户 IP 地址或 selfUrl。** 插件自动处理。
+- **只使用上面列出的工具。** 没有 `multiclaws_status` 工具。
+- **Bio 是自由格式的 markdown。** 写得让另一个 AI 能读懂这个智能体能做什么。
+- **每个智能体就像一个 skill。** 委派时读每个智能体的 bio，选最匹配的。
+- **只有名字需要用户明确确认**；bio 自动生成无需确认；网络情况仅告知无需回答。
+
+---
+
+## 工作流
+
+### 创建团队
+
+```
+1. multiclaws_profile_show()              — 检查档案
+2.（如果 ownerName 为空）确认名字，自动生成 bio
+3. multiclaws_team_create(name="...")     — 返回 inviteCode (mc:xxxx)
+4. 告诉用户把邀请码分享给队友
+```
+
+### 加入团队
+
+```
+1. multiclaws_profile_show()              — 检查档案
+2.（如果 ownerName 为空）确认名字，自动生成 bio
+3. multiclaws_team_join(inviteCode="mc:xxxx")
+   → 自动同步所有团队成员
+```
+
+### 委派任务
+
+所有委派（无论单轮还是多轮）都通过 `multiclaws_delegate` 进行。代码会自动 spawn 子 agent 执行，主 agent 立即返回，无需手动 `sessions_spawn`。
+
+```
+1. multiclaws_agents()                    — 列出智能体，读 bio
+2. 选择 bio 最匹配任务的智能体
+3. multiclaws_delegate(agentUrl="...", task="...")
+   → 代码自动 spawn 子 agent，子 agent 通过 message 实时汇报结果
+```
+
+选择智能体时：
+- 匹配任务领域和 bio（如「财务报告」→ 有财务技能的智能体）
+- 匹配数据需求（如「检查 API 代码」→ bio 中有该代码库的智能体）
+- 多个匹配时选最具体的
+
+需要联系多个智能体时，对每个智能体分别调用 `multiclaws_delegate`。
+
+#### 示例
+
+**单人任务：**
+```
+用户: "问一下小明他那个 API 接口的参数格式"
+
+1. multiclaws_delegate(小明, "你那个 API 接口的参数格式是什么？")
+   → 子 agent 自动发送、等待回复、通过 message 汇报结果
+```
+
+**多人任务：**
+```
+用户: "帮我和小明、小红约明天下午的会议"
+
+1. multiclaws_agents() → 找到小明、小红
+2. multiclaws_delegate(小明, "明天下午 2-5 点开会，你什么时候有空？")
+3. multiclaws_delegate(小红, "明天下午 2-5 点开会，你什么时候有空？")
+   → 每个委派各自 spawn 子 agent，通过 message 实时汇报进展
+```
+
+---
+
+## 网络配置
+
+所有实例通过 FRP 隧道通信。需要一台运行 frps 的公网服务器。
+frpc 会在首次启动时自动下载安装，无需手动安装。
+
+在插件配置中添加 tunnel 字段即可：
+```json
+{
+  "tunnel": {
+    "type": "frp",
+    "serverAddr": "你的frps地址",
+    "serverPort": 7000,
+    "token": "你的认证令牌",
+    "portRangeStart": 7011,
+    "portRangeEnd": 7020
+  }
+}
+```
+
+当加入或委派因网络错误失败时（ECONNREFUSED、ETIMEDOUT、fetch failed），引导用户：
+
+> 网络连接失败，请检查：
+> 1. 确认 frpc 已正常启动（查看日志中的 `[frp] FRP tunnel ready` 信息）
+> 2. 检查插件配置中的 `tunnel.serverAddr` / `tunnel.token` 是否正确
+> 3. 确认 frps 服务器可达（`telnet frps地址 端口`）
+> 4. 重启 OpenClaw