lark-workflow-standup-report

name	lark-workflow-standup-report
version	1.0.0
description	日程待办摘要：编排 calendar +agenda 和 task +get-my-tasks，生成指定日期的日程与未完成任务摘要。适用于了解今天/明天/本周的安排。
metadata	{"requires":{"bins":["lark-cli"]}}

⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）

本技能依赖本地 lark-cli（@larksuite/cli，可用 command -v lark-cli 定位）及其 ~/.lark-cli 登录态（应用密钥存于 macOS keychain）。

在 Cowork 中运行任何 lark-cli 命令时，必须在本地 macOS 上执行（使用 Desktop Commander 的 start_process / interact_with_process，或其它本地 shell 工具），不要用隔离的 Linux 沙箱 mcp__workspace__bash——沙箱里没有 lark-cli、也读不到 keychain。 执行前确保 npm 全局 bin 目录（npm prefix -g 输出目录下的 bin）在 PATH 中。

（在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）

日程待办摘要工作流

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}（根据日程推算）

数据处理规则：

1. 时间转换：API 返回 Unix timestamp，需根据 timezone 字段（通常为 Asia/Shanghai）转换为 HH:mm 格式
2. RSVP 状态映射：

   API 值	显示文案
   accept	已接受
   decline	已拒绝
   needs_action	待确认
   tentative	暂定

3. 日程排序：按开始时间升序排列
4. 冲突检测：按时间排序后，检查相邻日程是否有时间重叠（前一个 end_time > 后一个 start_time），有则在小结中列出冲突组
5. 已拒绝日程：标注"已拒绝"但不计入忙碌时段和冲突检测
6. 待办排序：按截止时间升序，已过期的标注"已过期"，无截止时间的排在最后

权限表

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

参考

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