| name | amemo-find-task |
| description | 当用户说「查看清单/查询清单/我的待办/查看任务/列出任务」时调用，返回按今日/明日/近期/未来分组的完整待办清单。 |
amemo-find-task — 查询任务
接口信息
| 属性 | 值 |
|---|
| 路由 | POST https://skill.amemo.cn/find-task |
| Bean | TaskBean |
| Content-Type | application/json |
请求参数
⚠️ 服务端要求所有字段必须存在。userToken 必填且有值，其他字段可选但字段必须存在。
| 参数 | 类型 | 必填 | 说明 |
|---|
userToken | str | ✅ | 用户登录凭证 |
taskId | str | — | 按 ID 精确查询，不传则传 null |
taskTitle | str | — | 按标题模糊查询，不传则传 null |
taskTime | str | — | 按时间筛选，不传则传 null |
taskEmail | list[str] | — | 按邮箱筛选，不传则传 null |
请求示例
curl -X POST https://skill.amemo.cn/find-task \
-H "Content-Type: application/json" \
-d '{
"userToken": "<token>",
"taskId": null,
"taskTitle": null,
"taskTime": null,
"taskEmail": null
}'
curl -X POST https://skill.amemo.cn/find-task \
-H "Content-Type: application/json" \
-d '{
"userToken": "<token>",
"taskId": null,
"taskTitle": "报告",
"taskTime": null,
"taskEmail": null
}'
响应数据结构
{
"code": 200,
"desc": "success",
"data": {
"recommend": [],
"myFollow": [],
"todayList": [],
"tomorrowList": [],
"recentList": [],
"finishList": [],
"futureList": []
}
}
TaskInfo 任务信息
| 字段 | 类型 | 说明 |
|---|
taskId | str | 任务唯一标识 |
taskTitle | str | 任务标题 |
recentRemindTime | int | 最近的提醒时间 |
待办清单展示模板
无数据时回复
**📋 暂无待办清单**
> 创建新任务 →
> • 「今天 3 点开会」
> • 「提醒我明天交报告」
任务清单展示模板
**✅ 待办清单** · 共 {total} 项
---
### 📅 今日待办
- ⏳ {task1}
- ⏳ {task2}
- ⏳ {task3}
---
### 📆 明日待办 ({count})
- ⏳ {task1}
---
### 📋 近期待办 ({count})
- ⏳ {task1}
---
### 🔮 未来待办 ({count})
- ⏳ {task1}
---
### ⭐ 收藏 ({count})
- ★ {task1}
---
### ✔ 已完成 ({count})
- ✓ {task1}
单个任务项格式化
| 任务类型 | 格式 |
|---|
| 待做任务 | {index}. {taskTitle} |
| 收藏任务 | {index}. ⭐ {taskTitle} |
| 已完成任务 | {index}. ✔ {taskTitle} |
任务状态图标
| 状态 | 图标 | 说明 |
|---|
| pending | ⏳ | 待完成 |
| completed | ✔ | 已完成 |
| expired | ❌ | 已过期 |
| follow | ⭐ | 已收藏 |
分组展示优先级
| 优先级 | 分类 | 说明 |
|---|
| 1 | 今日待办 | 今日必须完成的任务，优先展示 |
| 2 | 明日待办 | 明日计划的任务 |
| 3 | 近期待办 | 未来15天内的任务 |
| 4 | 未来待办 | 15天之后的任务 |
| 5 | 我的收藏 | 用户收藏的重要任务 |
| 6 | 已完成 | 已完成的任务 |
分类计数统计
| 分类 | 数量 |
|:-----|:----:|
| 今日待办 | {count} |
| 明日待办 | {count} |
| 近期待办 | {count} |
| 未来待办 | {count} |
| 我的收藏 | {count} |
| 已完成 | {count} |
| **总计** | **{count}** |
任务为空时处理
如果某分类为空：
| 分类 | 空状态提示 |
|---|
| 今日/明日/近期 | 暂无15天内待办 |
| 未来 | 暂无未来待办 |
| 收藏 | 暂无收藏任务 |
| 已完成 | 暂无已完成任务 |
输出示例
**✅ 待办清单** · 共 17 项
---
### 📅 今日待办
- ⏳ 完成项目报告
- ⏳ 提交代码审查
- ⏳ 准备会议材料
---
### 📆 明日待办 (2)
- ⏳ 产品需求评审
- ⏳ 团队周会
---
### 📋 近期待办 (4)
- ⏳ 客户方案调整
- ⏳ 技术文档更新
- ⏳ 测试报告评审
- ⏳ 版本发布准备
---
### 🔮 未来待办 (2)
- ⏳ 季度 OKR 制定
- ⏳ 年度总结规划
---
### ⭐ 收藏 (1)
- ★ 年度总结
---
### ✔ 已完成 (5)
- ✓ 登录功能开发
- ✓ 数据库优化
- ✓ API 接口调试
- ✓ 前端页面联调
- ✓ 部署文档编写
调用示例
示例一：查看待办清单
用户输入：
查看我的待办清单
系统处理：
- 检查
userToken
- 调用
POST /find-task
- 解析返回数据，按分类组织展示
示例二：查找清单
用户输入：
查找我的清单
系统处理：
- 检查
userToken
- 调用
POST /find-task
- 格式化输出给用户
执行流程（由主模块调度）
执行步骤
1. 识别触发词（查看/查询/列出 + 清单/任务/待办）
↓
2. 检查 userToken 是否存在
├── 无 token → 引导登录流程
↓
3. 调用 POST /find-task 接口
↓
4. 解析返回数据
├── todayList: 今日列表
├── tomorrowList: 明日列表
├── recentList: 近期列表（15天内）
├── futureList: 未来列表
├── finishList: 已完成列表
└── myFollow: 我的收藏
↓
5. 按分类组织并格式化输出
回复模板
无数据时
**📋 暂无待办清单**
> 创建新任务 →
> • 「今天 3 点开会」
> • 「提醒我明天交报告」
