mm_ai 1.0.0

package/example/project/ai_secretary/skills/dialogue_management_skill.md

@@ -0,0 +1,167 @@
+# 对话管理技能（dialogue_management_skill）
+
+## 基本信息
+- **名称**: dialogue_management_skill
+- **描述**: 让智能体能维护多轮对话上下文，进行连贯的对话交互，在无法理解时给出引导提示
+- **依赖工具**: 无（依赖智能体自身的对话管理能力）
+
+## 触发条件
+本技能在所有对话场景中自动启用：
+- 任何用户发起的对话
+- 需要维护对话上下文时
+- 需要处理多轮交互时
+- 用户表达不清需要引导时
+
+## 输入假设
+- 用户可能在多轮对话中逐步完善需求
+- 用户可能使用代词（它、这个、那个、那里）指代前文内容
+- 用户可能在当前对话中切换话题
+- 用户可能纠正之前的输入
+
+## 执行步骤
+
+### 步骤1：初始化/恢复对话上下文
+- 每次接收用户消息时，加载当前会话的对话历史
+- 维护以下上下文信息：
+
+```json
+{
+  "sessionId": "会话ID",
+  "turnCount": 5,              // 当前对话轮次
+  "currentIntent": "query_weather",  // 当前意图
+  "lastIntent": "add_schedule",      // 上一个意图
+  "entities": {                      // 已提取的实体
+    "city": "北京",
+    "date": "2025-07-30"
+  },
+  "pendingConfirm": null,            // 待用户确认的内容
+  "lastActionResult": {              // 上一个操作结果
+    "success": true,
+    "message": "日程添加成功"
+  },
+  "referencedItems": [               // 对话中提到的项目
+    { "type": "schedule", "id": "sch_001", "title": "项目会议" },
+    { "type": "todo", "id": "todo_001", "title": "提交周报" }
+  ]
+}
+```
+
+### 步骤2：上下文理解
+- 解析当前用户输入，结合上下文理解完整含义
+
+#### 代词消解
+| 用户输入 | 上下文 | 理解结果 |
+|---------|--------|---------|
+| "那个会议改到4点" | 前文提到"项目会议" | 修改日程"项目会议"，时间改为16:00 |
+| "它完成了" | 前文提到"提交周报" | 标记待办"提交周报"为已完成 |
+| "那里的天气呢" | 前文提到"北京"和"上海" | 查询另一个城市的天气 |
+
+#### 省略补全
+| 用户输入 | 上下文 | 理解结果 |
+|---------|--------|---------|
+| "改成4点" | 前文：修改日程"项目会议" | 修改"项目会议"开始时间为16:00 |
+| "还有呢" | 前文：展示了部分日程 | 继续展示更多日程 |
+| "也加一个" | 前文：添加了"提交周报" | 继续添加新的待办 |
+
+### 步骤3：话题管理
+- 跟踪当前话题，当用户切换话题时平滑过渡
+
+#### 话题切换处理
+```
+用户：北京今天天气怎么样？
+秘书：🌍 北京今天天气...（天气话题）
+用户：好的，那帮我记个事，周五前交周报
+秘书：✅ 已添加待办...（切换到待办话题）
+```
+
+#### 话题延续
+```
+用户：帮我看看明天的日程
+秘书：📋 您明天的日程...
+用户：帮我改一下，把晨会调到10点
+秘书：✅ 已修改...（延续日程话题）
+```
+
+### 步骤4：多轮信息收集
+- 当用户提供的信息不完整时，通过多轮对话逐步收集
+
+#### 信息收集流程示例
+```
+用户：帮我加个日程
+秘书：好的，请问日程的标题是什么？
+用户：项目评审会
+秘书：什么时间开始呢？
+用户：明天下午3点
+秘书：好的，已为您添加日程"项目评审会"...（信息收集完成，执行操作）
+```
+
+### 步骤5：确认与纠错
+- 关键操作（删除、修改）前向用户确认
+- 用户纠错时更新上下文
+
+#### 确认流程
+```
+秘书：您要删除日程"项目会议"（15:00-16:00），确认删除吗？
+用户：确认
+秘书：✅ 已删除日程"项目会议"
+```
+
+#### 纠错处理
+```
+用户：查一下北京天气
+秘书：🌍 北京今天天气...
+用户：我说的是上海
+秘书：抱歉，马上为您查询上海天气...
+```
+
+### 步骤6：引导与帮助
+- 当无法理解用户意图时，给出可操作的引导提示
+- 当用户首次使用或请求帮助时，介绍核心功能
+
+#### 无法理解时的引导
+```
+抱歉，我没有完全理解您的意思。您可以尝试以下指令：
+🌤️ 查天气：例如"北京天气"
+📅 管日程：例如"明天下午3点开会"
+📋 管待办：例如"记一下周五前交周报"
+```
+
+#### 首次使用欢迎
+```
+您好！我是您的AI秘书，可以帮您：
+🌤️ 查询天气
+📅 管理日程（添加/查看/修改/删除）
+📋 管理待办（创建/查看/标记完成）
+有什么可以帮您的吗？
+```
+
+### 步骤7：对话历史管理
+- 保持对话历史的合理长度（保留最近20轮对话）
+- 超出时，总结关键上下文信息后丢弃早期对话
+- 关键上下文信息包括：用户偏好、待确认项、最近的操作结果
+
+## 中间检查点
+- ✅ 是否有对话上下文？是否利用了前文信息？
+- ✅ 用户输入中是否有代词？能否正确消解？
+- ✅ 是否需要向用户确认操作？
+- ✅ 用户是否切换了话题？
+- ✅ 用户输入是否完整？是否需要继续收集信息？
+
+## 输出格式
+- 保持一致的对话风格：礼貌、专业、友好
+- 使用emoji提升表达丰富度
+- 关键信息使用**加粗**突出
+- 列表使用数字或符号有序排列
+
+## 失败回退
+- 如果连续3轮无法理解用户意图：主动提供帮助菜单
+- 如果用户表达极度模糊：给出具体示例引导
+- 如果对话历史过长：总结关键信息后压缩
+- 如果上下文不一致（如用户说"不是"）：重置当前操作并重新理解
+
+## 禁止行为
+- ❌ 禁止混淆不同话题的上下文信息
+- ❌ 禁止在未确认的情况下执行破坏性操作（删除/修改）
+- ❌ 禁止忽略用户的纠错信息
+- ❌ 禁止在对话历史中保留过长无用的对话
+- ❌ 禁止在不同用户的会话之间共享上下文

package/example/project/ai_secretary/skills/natural_language_skill.md

@@ -0,0 +1,119 @@
+# 自然语言理解技能（natural_language_skill）
+
+## 基本信息
+- **名称**: natural_language_skill
+- **描述**: 让智能体能理解用户各种表达方式的自然语言，准确识别用户意图（查天气、管日程、管待办等），提取关键实体信息
+- **依赖工具**: 无（依赖智能体自身的自然语言处理能力）
+
+## 触发条件
+本技能作为智能体的核心交互能力，在所有用户对话中自动启用：
+- 用户在首次对话时
+- 用户发送任何自然语言消息时
+- 需要理解用户意图并分派到具体业务技能时
+
+## 输入假设
+用户输入可以是：
+- 简短指令：如"北京天气"、"加个日程"
+- 完整句子：如"帮我看看明天下午有什么安排"
+- 模糊表达：如"今天热吗"（隐含查天气意图）
+- 多意图混合：如"查一下北京天气，然后帮我记个待办"
+- 上下文依赖：如"那个会议改到4点"（依赖前文提到的会议）
+
+## 执行步骤
+
+### 步骤1：接收用户输入
+- 接收用户的自然语言消息
+- 结合对话历史上下文理解当前输入
+
+### 步骤2：意图识别
+从以下预定义意图中识别用户的核心意图：
+
+| 意图类别 | 意图名称 | 典型用户表达 |
+|---------|---------|-------------|
+| 天气查询 | query_weather | "北京天气"、"今天热吗"、"明天上海下雨吗" |
+| 添加日程 | add_schedule | "安排明天下午3点开会"、"加个日程" |
+| 查看日程 | list_schedule | "看看我今天的日程"、"这周有什么安排" |
+| 修改日程 | update_schedule | "把会议改到4点"、"修改一下日程" |
+| 删除日程 | delete_schedule | "删除明天的会议"、"取消这个日程" |
+| 创建待办 | add_todo | "记一下周五前交周报"、"添加待办" |
+| 查看待办 | list_todo | "我的待办有哪些"、"看看清单" |
+| 更新待办 | update_todo | "把买牛奶标记为完成" |
+| 删除待办 | delete_todo | "删除买牛奶" |
+| 打招呼 | greeting | "你好"、"嗨"、"在吗" |
+| 求助 | help | "你能做什么"、"帮助"、"功能" |
+| 闲聊 | chitchat | 与功能无关的日常对话 |
+
+### 步骤3：实体提取
+根据识别出的意图，提取关键实体信息：
+
+#### 天气查询实体
+| 实体 | 类型 | 提取规则 |
+|------|------|---------|
+| 城市名 | 地点 | 北京、上海、广州等中国城市名，或国外城市名 |
+| 日期 | 时间 | 今天、明天、后天、周X、具体日期等 |
+
+#### 日程管理实体
+| 实体 | 类型 | 提取规则 |
+|------|------|---------|
+| 标题 | 文本 | 事件名称，如"会议"、"约会"、"聚餐" |
+| 时间 | 时间 | 具体时间、相对时间、时间段 |
+| 地点 | 地点 | 会议室、餐厅、公司等 |
+| 备注 | 文本 | 额外说明 |
+
+#### 待办管理实体
+| 实体 | 类型 | 提取规则 |
+|------|------|---------|
+| 标题 | 文本 | 任务描述 |
+| 截止日期 | 时间 | 截止时间 |
+| 优先级 | 枚举 | 高/中/低 |
+
+### 步骤4：意图消歧
+- 如果意图置信度低于阈值（<70%），通过追问明确用户意图
+- 如果检测到多个意图，按顺序处理或询问用户优先处理哪个
+- 如果用户输入模糊，给出引导式选项
+
+#### 模糊意图处理示例
+```
+用户：今天有什么事情吗？
+分析：可能想查日程（list_schedule），也可能想查看待办（list_todo）
+回应：请问您想查看今天的日程安排，还是待办事项？
+```
+
+### 步骤5：分派到具体技能
+- 将识别出的意图和提取的实体传递给对应的业务技能
+- 调用链：natural_language_skill → 具体业务技能（weather_query_skill / schedule_management_skill / todo_management_skill）
+
+### 步骤6：时间表达解析规则
+- "今天" → 当前日期
+- "明天" → 当前日期+1天
+- "后天" → 当前日期+2天
+- "大后天" → 当前日期+3天
+- "本周X" → 当前周的周X
+- "下周X" → 下周的周X
+- "X月X日" → 当前年份的X月X日
+- "X点"、"X:XX" → 当天或指定日期的具体时间
+- "上午" → 默认 08:00-12:00
+- "下午" → 默认 12:00-18:00
+- "晚上" → 默认 18:00-22:00
+- "半小时后"、"一小时后" → 当前时间+N
+
+## 中间检查点
+- ✅ 是否已识别出用户意图？未识别需追问
+- ✅ 是否已提取核心实体？缺少关键信息需追问
+- ✅ 是否有上下文依赖？需结合历史对话
+- ✅ 是否存在歧义？需消歧处理
+
+## 输出格式
+- 意图识别结果：{ "intent": "意图名称", "entities": { "实体名": "值" }, "confidence": 0.95 }
+- 呈现给用户时：使用友好、自然的对话语言
+
+## 失败回退
+- 如果意图识别置信度低于50%：使用引导式回复，如"我不太明白您的意思，您可以试试这样说：'北京天气'、'帮我安排明天下午3点开会'、'我的待办有哪些'"
+- 如果实体提取失败：追问缺失的关键信息
+- 如果出现完全不理解的输入：礼貌表示无法理解，并提供示例
+
+## 禁止行为
+- ❌ 禁止在未确认意图的情况下执行业务操作
+- ❌ 禁止将闲聊意图分派到业务技能
+- ❌ 禁止编造用户未提及的实体信息
+- ❌ 禁止在单轮对话中执行多个未确认的操作

package/example/project/ai_secretary/skills/schedule_management_skill.md

@@ -0,0 +1,167 @@
+# 日程管理技能（schedule_management_skill）
+
+## 基本信息
+- **名称**: schedule_management_skill
+- **描述**: 让智能体掌握如何管理日程（增删改查+提醒），能从对话中提取日程信息（标题、时间、地点等），能在日程临近时主动提醒用户
+- **依赖工具**: schedule_manager（位于 `./project/ai_secretary/tools/schedule_manager.js`）
+
+## 触发条件
+当用户表达以下意图时触发本技能：
+- **添加日程**：如"帮我安排明天下午3点开会"、"添加一个日程"
+- **查看日程**：如"看看我今天的日程"、"这周有什么安排"
+- **修改日程**：如"把明天的会议改到4点"、"修改一下日程"
+- **删除日程**：如"删除明天的会议"、"取消这个日程"
+- **日程提醒**：到达提醒时间时主动通知用户
+
+## 输入假设
+用户输入为自然语言，可能包含：
+- **日程标题**：会议、约会、聚餐、活动等事件名称
+- **时间信息**：
+  - 具体时间：明天下午3点、后天上午10点、2025年8月1日14:00
+  - 相对时间：一小时后、半小时后
+  - 持续时间：1小时、两个小时
+- **地点信息**：会议室A、公司、家里等
+- **备注信息**：讨论Q3进度、带笔记本电脑等
+- **提醒时间**：提前15分钟、提前1小时等（默认提前15分钟）
+
+## 执行步骤
+
+### 步骤1：解析用户意图和日程信息
+- 判断用户意图：add（添加）、list（查看）、update（修改）、delete（删除）、remind（提醒）
+- 从自然语言中提取日程关键信息：
+  - 标题（title）：事件名称，如"项目会议"、"客户拜访"
+  - 开始时间（startTime）：ISO格式，如 "2025-07-30T15:00:00"
+  - 结束时间（endTime）：根据持续时间推算，默认1小时
+  - 地点（location）：如"会议室A"
+  - 备注（notes）：额外说明
+  - 提醒时间（reminderTime）：默认开始时间前15分钟
+
+### 步骤2：调用日程管理工具
+- 调用 `schedule_manager` 工具的 `main` 函数
+- 工具路径：`./project/ai_secretary/tools/schedule_manager.js`
+- 根据不同的操作类型传入参数：
+
+#### 添加日程（action: 'add'）
+```json
+{
+  "action": "add",
+  "data": {
+    "title": "项目会议",
+    "startTime": "2025-07-30T15:00:00",
+    "endTime": "2025-07-30T16:00:00",
+    "location": "会议室A",
+    "notes": "讨论Q3进度",
+    "reminderTime": "2025-07-30T14:45:00"
+  }
+}
+```
+
+#### 查看日程（action: 'list'）
+```json
+{
+  "action": "list",
+  "data": {
+    "date": "2025-07-30",       // 按日期筛选（可选）
+    "startDate": "2025-07-28",   // 日期范围起点（可选）
+    "endDate": "2025-08-03",     // 日期范围终点（可选）
+    "status": "active",          // 状态筛选（可选）
+    "keyword": "会议"            // 关键词搜索（可选）
+  }
+}
+```
+
+#### 修改日程（action: 'update'）
+```json
+{
+  "action": "update",
+  "data": {
+    "id": "sch_001",
+    "title": "新标题",           // 要修改的字段
+    "startTime": "2025-07-30T16:00:00",
+    "location": "新地点"
+  }
+}
+```
+
+#### 删除日程（action: 'delete'）
+```json
+{
+  "action": "delete",
+  "data": {
+    "id": "sch_001"
+  }
+}
+```
+
+#### 检查提醒（action: 'remind'）
+```json
+{
+  "action": "remind"
+}
+```
+
+### 步骤3：处理返回结果并呈现
+
+#### 添加成功
+- 使用emoji增强可读性
+```
+✅ 已为您添加日程：项目会议
+📅 时间：2025年7月30日 15:00 - 16:00
+📍 地点：会议室A
+⏰ 已设置提前15分钟提醒
+```
+
+#### 查看日程
+- 按时间排序展示日程列表
+- 如果当天无日程：显示"您今天没有日程安排"
+- 如果有即将开始的日程（30分钟内）：标注 ⬅️ 即将开始
+```
+📋 您今天的日程如下：
+1. 09:00-10:00 晨会 - 会议室A
+2. 14:00-15:00 客户拜访 - 客户公司
+3. 15:30-16:30 项目会议 ⬅️ 即将开始
+```
+
+#### 修改成功
+```
+✅ 已修改日程"项目会议"，时间调整为 16:00-17:00
+```
+
+#### 删除成功
+```
+✅ 已删除日程"项目会议"
+```
+
+### 步骤4：日程提醒处理
+- 定期（如每分钟）调用 `schedule_manager` 的 `remind` 操作检查需要提醒的日程
+- 使用 `notify_user` 工具向用户发送提醒通知
+- 提醒格式：
+```
+⏰ 日程提醒
+📌 项目会议 即将在15分钟后开始
+📅 时间：15:00 - 16:00
+📍 地点：会议室A
+```
+
+## 中间检查点
+- ✅ 是否已明确用户的操作意图（add/list/update/delete）？
+- ✅ 添加日程时是否已提取标题和时间？如缺少必填信息需追问
+- ✅ 修改/删除时是否已确认是哪条日程？如果有多条匹配需让用户选择
+- ✅ 删除操作前是否已向用户确认？
+
+## 输出格式
+- 操作成功：用emoji+清晰格式展示结果
+- 操作失败：友好提示失败原因
+- 列表展示：按时间排序，标注即将开始的日程
+
+## 失败回退
+- 如果工具返回 `code === 10001`（未找到）：告知用户未找到该日程
+- 如果用户意图不明确：引导用户明确操作类型
+- 如果时间解析失败：询问用户具体时间
+- 删除前必须得到用户确认
+
+## 禁止行为
+- ❌ 禁止在未确认的情况下删除日程
+- ❌ 禁止编造日程数据
+- ❌ 禁止修改不存在的日程
+- ❌ 禁止在用户未授权的情况下查看他人日程

package/example/project/ai_secretary/skills/todo_management_skill.md

@@ -0,0 +1,156 @@
+# 待办管理技能（todo_management_skill）
+
+## 基本信息
+- **名称**: todo_management_skill
+- **描述**: 让智能体掌握如何管理待办（增删改查+状态标记），能从对话中提取待办信息（标题、截止日期、优先级等）
+- **依赖工具**: todo_manager（位于 `./project/ai_secretary/tools/todo_manager.js`）
+
+## 触发条件
+当用户表达以下意图时触发本技能：
+- **创建待办**：如"帮我记一下，周五前要提交周报"、"添加待办：买牛奶"
+- **查看待办**：如"我的待办有哪些"、"看看待办清单"
+- **标记完成**：如"把提交周报标记为已完成"、"完成买牛奶"
+- **修改待办**：如"把买牛奶的优先级改为高"、"改一下截止日期"
+- **删除待办**：如"删除买牛奶"、"移除这个待办"
+
+## 输入假设
+用户输入为自然语言，可能包含：
+- **待办标题**：要完成的任务描述，如"提交周报"、"买牛奶"
+- **截止日期**：如"周五前"、"下周一"、"明天"
+- **优先级**：高/中/低、重要/紧急等（默认中）
+- **状态**：待办/已完成
+
+## 执行步骤
+
+### 步骤1：解析用户意图和待办信息
+- 判断用户意图：add（创建）、list（查看）、update（更新状态/修改）、delete（删除）
+- 从自然语言中提取待办关键信息：
+  - 标题（title）：任务描述，如"提交周报"
+  - 截止日期（dueDate）：格式 YYYY-MM-DD
+  - 优先级（priority）：'high'（高）、'medium'（中）、'low'（低），默认'medium'
+  - 状态（status）：'pending'（待办）、'completed'（已完成）
+
+### 步骤2：调用待办管理工具
+- 调用 `todo_manager` 工具的 `main` 函数
+- 工具路径：`./project/ai_secretary/tools/todo_manager.js`
+- 根据不同的操作类型传入参数：
+
+#### 创建待办（action: 'add'）
+```json
+{
+  "action": "add",
+  "data": {
+    "title": "提交周报",
+    "dueDate": "2025-08-01",
+    "priority": "medium"
+  }
+}
+```
+
+#### 查看待办（action: 'list'）
+```json
+{
+  "action": "list",
+  "data": {
+    "status": "all",              // all全部/pending待办/completed已完成，默认pending
+    "priority": "high",           // 按优先级筛选（可选）
+    "keyword": "周报",            // 关键词搜索（可选）
+    "sortBy": "dueDate",          // 排序字段：dueDate/priority/createdAt
+    "sortOrder": "asc"            // 排序方向：asc升序/desc降序
+  }
+}
+```
+
+#### 更新待办（action: 'update'）
+```json
+{
+  "action": "update",
+  "data": {
+    "id": "todo_001",
+    "title": "新标题",           // 要修改的字段
+    "dueDate": "2025-08-05",
+    "priority": "high",
+    "status": "completed"        // 标记完成
+  }
+}
+```
+
+#### 删除待办（action: 'delete'）
+```json
+{
+  "action": "delete",
+  "data": {
+    "id": "todo_001"
+  }
+}
+```
+
+### 步骤3：处理返回结果并呈现
+
+#### 创建成功
+```
+✅ 已添加待办事项：
+📝 提交周报
+📅 截止日期：2025年8月1日（周五）
+🔴 优先级：普通
+```
+
+#### 查看待办
+- 按状态分组展示
+- 统计信息：总数、待办数、已完成数
+```
+📋 您的待办清单（共5项，待办3项）：
+
+⏳ 待办事项：
+⬜ [高] 提交周报 - 截止：周五
+⬜ [中] 预约牙医 - 截止：下周一
+⬜ [低] 买牛奶 - 截止：明天
+
+✅ 已完成：
+✅ 购买办公用品
+✅ 回复邮件
+```
+
+#### 标记完成
+```
+✅ 已标记"提交周报"为已完成 🎉
+```
+
+#### 修改成功
+```
+✅ 已更新待办"买牛奶"，优先级改为"高"
+```
+
+#### 删除成功
+```
+✅ 已删除待办"买牛奶"
+```
+
+### 步骤4：优先级映射
+- 用户说"重要"、"紧急"、"高优先级" → 'high'
+- 用户说"普通"、"一般"、"中优先级" → 'medium'（默认）
+- 用户说"低"、"不着急"、"低优先级" → 'low'
+
+## 中间检查点
+- ✅ 创建待办时是否已提取标题？如缺少标题需追问
+- ✅ 标记完成时是否确认是哪条待办？多条匹配需让用户选择
+- ✅ 删除前是否已向用户确认？
+- ✅ 查看待办时用户是否指定了筛选条件？
+
+## 输出格式
+- 创建成功：显示标题、截止日期、优先级，使用emoji
+- 查看列表：分组展示（待办/已完成），含统计信息
+- 标记完成：确认信息+🎉
+- 删除：需确认后再执行
+
+## 失败回退
+- 如果工具返回 `code === 10001`（未找到）：告知用户未找到该待办
+- 如果用户意图不明确：引导用户明确要做什么操作
+- 如果优先级解析失败：使用默认值'medium'
+- 删除前必须得到用户确认
+
+## 禁止行为
+- ❌ 禁止在未确认的情况下删除待办
+- ❌ 禁止编造待办数据
+- ❌ 禁止修改不存在的待办
+- ❌ 禁止擅自修改待办的创建时间和更新时间