lark-workflow-standup-report
larksuite/cli
Generate a daily standup report by combining Lark calendar events and incomplete tasks for any date.
What is lark-workflow-standup-report?
lark-workflow-standup-report orchestrates two lark-cli commands—`calendar +agenda` and `task +get-my-tasks`—to fetch calendar events and incomplete tasks for a specified date, then produces a structured summary with time conversion, conflict detection, and sorted task lists. Designed for daily standups, morning briefings, and weekly schedule reviews.
- Fetches calendar events for today, a specific date, or a date range using ISO 8601 timestamps
- Retrieves incomplete tasks (--complete=false) optionally filtered by due date
- Converts Unix timestamps to HH:mm local time using the timezone field from the API
- Maps RSVP statuses (accept/decline/tentative/needs_action) to human-readable labels
- Detects scheduling conflicts by checking overlapping start/end times across events
- Outputs a structured markdown summary with a schedule table, task checklist, conflict alerts, and free-time slots
How to install lark-workflow-standup-report
npx skills add null --skill lark-workflow-standup-report- lark-cli must be installed and available in PATH
- User identity (not bot) must be authenticated: lark-cli auth login --domain calendar,task
- calendar:calendar.event:read scope must be granted
- task:task:read scope must be granted
- The lark-shared SKILL.md must be readable by the agent for auth and permission handling
How to use lark-workflow-standup-report
- 1.Install the skill: npx skills add null --skill lark-workflow-standup-report
- 2.Ensure lark-cli is authenticated: run `lark-cli auth login --domain calendar,task`
- 3.Ask the agent for a standup report, e.g. 'What are my meetings and tasks today?' or 'Give me tomorrow's schedule'
- 4.The agent runs `lark-cli calendar +agenda` (with --start/--end in ISO 8601 if not today) to fetch events
- 5.The agent runs `lark-cli task +get-my-tasks --complete=false` (optionally with --due-end) to fetch pending tasks
- 6.The agent converts timestamps, maps RSVP statuses, sorts events by start time, and checks for conflicts
- 7.Review the output: a markdown table of events, a task checklist, conflict alerts, and free-time slots
Use cases
- Daily standup report: what meetings and pending tasks do I have today?
- Morning briefing: summarize tomorrow's calendar and overdue tasks
- Weekly planning: review all events and incomplete tasks for the current week
- Pre-meeting prep: quickly check if any events conflict on a given day
- End-of-day check: list tasks still pending before close of business
- Individual contributors who use Lark Calendar and Lark Tasks and want a quick daily overview
- Engineering or product teams running daily standups via a coding agent
- Anyone using Claude Code or Cursor with lark-cli already configured
- Users who need automated schedule summaries without manually checking two separate Lark apps
lark-workflow-standup-report FAQ
The lark-cli --start and --end flags only accept ISO 8601 format (e.g. 2026-03-26T00:00:00+08:00) or Unix timestamps. The agent calculates the target date from the current date and formats it accordingly.
No. The workflow explicitly passes --complete=false to get-my-tasks. Omitting this flag would return both completed and incomplete tasks, polluting the standup summary.
By default get-my-tasks returns up to 20 tasks. Add --page-all to retrieve all pages. For standup summaries, using --due-end to filter by date is recommended to reduce data volume.
After sorting events by start time, the agent checks if any event's end_time is later than the next event's start_time. Conflicting pairs are listed in the summary's 'conflict alerts' section. Declined events are excluded from conflict detection.
No. This workflow only supports user identity. You must authenticate as a user via `lark-cli auth login`.
Full instructions (SKILL.md)
Source of truth, from larksuite/cli.
name: lark-workflow-standup-report version: 1.0.0 description: "日程待办摘要:编排 calendar +agenda 和 task +get-my-tasks,生成指定日期的日程与未完成任务摘要。适用于了解今天/明天/本周的安排。" metadata: requires: bins: ["lark-cli"]
日程待办摘要工作流
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证、权限处理
适用场景
- "今天有什么安排" / "今天的日程和待办"
- "明天有什么会" / "明日日程与未完成任务"
- "帮我看看今天要做什么" / "早报摘要"
- "开工摘要" / "standup report"
- "这周还有哪些安排"
前置条件
仅支持 user 身份。执行前确保已授权:
lark-cli auth login --domain calendar,task
工作流
{date} ─┬─► calendar +agenda [--start/--end] ──► 日程列表(会议/事件)
└─► task +get-my-tasks --complete=false [--due-end] ──► 未完成待办列表
│
▼
AI 汇总(时间转换 + 冲突检测 + 排序)──► 摘要
Step 1: 获取日程
# 今天(默认,无需额外参数)
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"
注意:
--start/--end仅支持 ISO 8601 格式(如2026-01-01或2026-01-01T15:04:05+08:00)和 Unix timestamp,不支持"tomorrow"、"next monday"等自然语言。需要 AI 根据当前日期自行计算目标日期。
输出包含:event_id、summary、start_time(含 timestamp + timezone)、end_time、free_busy_status、self_rsvp_status。
Step 2: 获取未完成待办
# 默认 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
注意:
+get-my-tasks不带--complete时会同时返回已完成和未完成任务,会把已完成任务当成"待办"展示进摘要里。站会/日报这种 pending 汇总场景必须显式带上--complete=false,不要省略。数据量层面也建议加过滤:
- 用
--due-end过滤出目标日期前到期的任务- 如果也需要无截止日期的任务,可不加
--due-end,但 AI 汇总时只展示近 30 天内创建的,其余折叠为"其他 N 项历史待办"
Step 3: AI 汇总
将 Step 1 和 Step 2 的结果整合,按以下结构输出:
## {日期}摘要({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 状态映射:
API 值 显示文案 accept已接受 decline已拒绝 needs_action待确认 tentative暂定 - 日程排序:按开始时间升序排列
- 冲突检测:按时间排序后,检查相邻日程是否有时间重叠(前一个 end_time > 后一个 start_time),有则在小结中列出冲突组
- 已拒绝日程:标注"已拒绝"但不计入忙碌时段和冲突检测
- 待办排序:按截止时间升序,已过期的标注"已过期",无截止时间的排在最后
权限表
| 命令 | 所需 scope |
|---|---|
calendar +agenda | calendar:calendar.event:read |
task +get-my-tasks | task:task:read |
参考
- lark-shared — 认证、权限(必读)
- lark-calendar —
+agenda详细用法 - lark-task —
+get-my-tasks详细用法
Related skills
More from larksuite/cli and the wider catalog.
lark-doc
飞书云文档(Docx / Wiki 文档):读取和编辑飞书文档内容。当用户给出文档 URL 或 token,或需要查看、创建、编辑文档、插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板,先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时,也应直接使用本 skill;路由依据是 URL 路径模式和 token,而不是域名。不负责文档评论管理,也不负责表格或 Base 的数据操作。
lark-base
飞书多维表格(Base)操作:建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、workflow、角色权限;遇到 Base/多维表格/bitable 或 /base/ 链接时使用。文件导入转 lark-drive,认证/授权转 lark-shared。
lark-im
飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件(支持大文件分片下载)、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片(Interactive Card)、监听卡片按钮回调(card.action.trigger)。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶(添加/移除/查询置顶会话)、管理标签数据、处理卡片回调时使用。
lark-drive
飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token,或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用;doubao.com 云空间 URL/token 也按资源路径和 token 路由,不回退 WebFetch。不负责:文档内容编辑(走 lark-doc)、表格/Base 表内数据操作(走 lark-sheets/lark-base)、知识空间节点/成员管理(走 lark-wiki)、原生 Markdown 文件读写/patch/diff(走 lark-markdown)。
lark-shared
Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling _notice JSON.
lark-calendar
飞书日历:管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责:查询过去的视频会议记录(走 lark-vc)、待办任务(走 lark-task)。