SuperAPI AI 工具集

lark-workflow-standup-report

办公与效率

查看项目

更新于 10-15 08:33

技能介绍

用途

这是一个“日程待办摘要”工作流,把 Lark 的日历日程与任务待办拉到一起,汇总成一份指定日期的摘要。典型使用场景包括:

  • “今天有什么安排” / “今天的日程和待办”
  • “明天有什么会” / “明日日程与未完成任务”
  • “帮我看看今天要做什么” / “早报摘要”
  • “开工摘要” / “standup report”
  • “这周还有哪些安排”

主要能力

工作流分三步:

  1. 获取日程:通过 calendar +agenda 拿到指定日期的日程列表(会议/事件),输出含 event_id、summary、start_time(timestamp + timezone)、end_time、free_busy_status、self_rsvp_status。
  2. 获取未完成待办:通过 task +get-my-tasks --complete=false 拿到未完成任务列表,可用 --due-end 限定到期时间。
  3. AI 汇总:整合前两步结果,做时间转换、冲突检测与排序,输出摘要。

摘要结构为:

## {日期}摘要({YYYY-MM-DD 星期X})

### 日程安排
| 时间 | 事件 | 组织者 | 状态 |
|------|------|--------|------|
| 09:00-10:00 | 产品需求评审 | 张三 | 已接受 |
| 14:00-15:00 | 技术方案讨论 | 李四 | 待确认 |

### 待办事项
- [ ] {task_summary}(截止:{due_date})
- [ ] {task_summary}

### 小结
- 共 {n} 场会议,{m} 项待办
- 冲突提醒:{列出时间重叠的日程}
- 空闲时段:{free_slots}(根据日程推算)

数据处理规则:

  • 时间转换:API 返回 Unix timestamp,需根据 timezone 字段(通常为 Asia/Shanghai)转换为 HH:mm 格式。
  • RSVP 状态映射:accept→已接受,decline→已拒绝,needs_action→待确认,tentative→暂定。
  • 日程排序:按开始时间升序排列。
  • 冲突检测:按时间排序后,检查相邻日程是否有时间重叠(前一个 end_time > 后一个 start_time),有则在小结中列出冲突组。
  • 已拒绝日程:标注“已拒绝”但不计入忙碌时段和冲突检测。
  • 待办排序:按截止时间升序,已过期的标注“已过期”,无截止时间的排在最后。

使用方式

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证、权限处理。

前置条件:仅支持 user 身份。执行前确保已授权:

lark-cli auth login --domain calendar,task

命令示例:

# 今天(默认,无需额外参数)
lark-cli calendar +agenda

# 指定日期范围(必须使用 ISO 8601 格式,不支持 "tomorrow" 等自然语言)
lark-cli calendar +agenda --start "2026-03-26T00:00:00+08:00" --end "2026-03-26T23:59:59+08:00"

# 默认 pending 摘要:必须显式过滤未完成任务(最多 20 条)
lark-cli task +get-my-tasks --complete=false

# 只看指定日期前到期的未完成任务(推荐用于摘要场景,减少数据量)
lark-cli task +get-my-tasks --complete=false --due-end "2026-03-27T23:59:59+08:00"

# 获取全部未完成任务(超过 20 条时)
lark-cli task +get-my-tasks --complete=false --page-all

注意事项:

  • --start / --end 仅支持 ISO 8601 格式(如 2026-01-01 或 2026-01-01T15:04:05+08:00)和 Unix timestamp,不支持 “tomorrow”“next monday” 等自然语言,需要 AI 根据当前日期自行计算目标日期。
  • +get-my-tasks 不带 --complete 时会同时返回已完成和未完成任务,会把已完成任务当成“待办”展示进摘要里。站会/日报这种 pending 汇总场景必须显式带上 --complete=false,不要省略。
  • 数据量层面也建议加过滤:用 --due-end 过滤出目标日期前到期的任务;如果也需要无截止日期的任务,可不加 --due-end,但 AI 汇总时只展示近 30 天内创建的,其余折叠为“其他 N 项历史待办”。

权限

命令 所需 scope
calendar +agenda calendar:calendar.event:read
task +get-my-tasks task:task:read

参考

  • lark-shared — 认证、权限(必读)
  • lark-calendar — +agenda 详细用法
  • lark-task — +get-my-tasks 详细用法