ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
123 lines
4.5 KiB
Markdown
123 lines
4.5 KiB
Markdown
---
|
||
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`](../lark-shared/SKILL.md)，其中包含认证、权限处理**
|
||
|
||
## 适用场景
|
||
|
||
- "今天有什么安排" / "今天的日程和待办"
|
||
- "明天有什么会" / "明日日程与未完成任务"
|
||
- "帮我看看今天要做什么" / "早报摘要"
|
||
- "开工摘要" / "standup report"
|
||
- "这周还有哪些安排"
|
||
|
||
## 前置条件
|
||
|
||
仅支持 **user 身份**。执行前确保已授权：
|
||
|
||
```bash
|
||
lark-cli auth login --domain calendar,task
|
||
```
|
||
|
||
## 工作流
|
||
|
||
```
|
||
{date} ─┬─► calendar +agenda [--start/--end] ──► 日程列表（会议/事件）
|
||
└─► task +get-my-tasks --complete=false [--due-end] ──► 未完成待办列表
|
||
│
|
||
▼
|
||
AI 汇总（时间转换 + 冲突检测 + 排序）──► 摘要
|
||
```
|
||
|
||
### Step 1: 获取日程
|
||
|
||
```bash
|
||
# 今天（默认，无需额外参数）
|
||
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: 获取未完成待办
|
||
|
||
```bash
|
||
# 默认 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-shared/SKILL.md) — 认证、权限（必读）
|
||
- [lark-calendar](../lark-calendar/SKILL.md) — `+agenda` 详细用法
|
||
- [lark-task](../lark-task/SKILL.md) — `+get-my-tasks` 详细用法
|