PicoBot/skills/lark-calendar/references/lark-calendar-agenda.md
ooodc a7883dbed9 refactor(todo): 重构待办事项管理逻辑及更新状态规则
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段
- 强制每个任务都必须有唯一 id,且由用户负责生成
- 修改合并模式逻辑,merge=true 下保留未提及的旧任务
- 支持已完成和已取消任务重新激活(状态改回 pending 或 in_progress)
- 禁止 in_progress 状态退回到 pending,必须标记为 completed 或 cancelled
- 优化状态转换校验,允许特定状态间合法切换
- 简化任务变更消息,移除详细的新增/更新/移除统计
- 更新文档和示例,明确 id 必须由用户生成和使用
- 修复和补充测试,增强状态转换和合并模式验证
- 调整任务时间戳生成逻辑,统一使用当前时间及索引
- 该变更提供更合理的任务状态机械及管理模式,提升稳定性和易用性
2026-06-13 09:22:33 +08:00

2.3 KiB
Raw Blame History

calendar +agenda

前置条件: 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

查看近期日程安排。只读操作,不修改任何日程。

需要的scopes: ["calendar:calendar.event:read"]

命令

# 查看今天日程(默认)
lark-cli calendar +agenda

# 自定义时间范围ISO 8601
lark-cli calendar +agenda --start "2026-03-10T00:00+08:00" --end "2026-03-17T00:00+08:00"

# 自定义时间范围(仅日期)
lark-cli calendar +agenda --start 2026-03-10 --end 2026-03-17

# 人类可读格式输出
lark-cli calendar +agenda --format pretty

# 指定日历
lark-cli calendar +agenda --calendar-id cal_xxx

参数

参数 必填 说明
--start <time> 开始时间ISO 8601 或仅日期,默认当天)
--end <time> 结束时间(默认与 --start 属于同一天,自动取当天结束时间)
--calendar-id <id> 日历 ID省略则使用主日历
--format 输出格式json默认 | pretty
--dry-run 预览 API 调用,不执行

时间格式

--start--end 支持以下格式:

格式 示例 说明
ISO 8601 2026-03-10T14:00:00+08:00 完整格式
日期+时间 2026-03-10 14:00:00 自动补全时区
仅日期 2026-03-10 start 取 00:00:00end 取 23:59:59
Unix 时间戳 1741564800 秒级时间戳

输出格式

将结果整理为易读的日程表:

## 2026-03-10 周一

09:00 - 09:30  站会
10:00 - 11:00  产品评审
14:00 - 15:00  与 Alice 1:1

## 2026-03-11 周二

(无日程)

注意:按日期分组,并严格按照开始时间升序(从早到晚的时间线)排序输出。 显示标题、时长

提示

  • 已取消的日程会自动过滤,无需额外处理。
  • 如无日程,告知用户"日程清空"。
  • 大于 40 天的时间范围会自动拆分查询并合并结果。
  • 查看多个日历:先用 lark-cli calendar calendars list --page-all 列出日历列表,再逐个查询。

参考