Lark日历与任务技能

在Lark（飞书）中创建、更新和删除日历事件与任务。

概述

此技能为以下内容提供完整的增删改查（CRUD）操作：

• 日历事件—— 会议、预约、日程安排
• 任务（待办事项）—— 带有截止时间的行动项

配置

所需环境变量（位于.secrets.env文件中）：

FEISHU_APP_ID=cli_a9f52a4ed7b8ded4
FEISHU_APP_SECRET=<your-app-secret>

默认日历： feishu.cn_caF80RJxgGcbBGsQx64bCh@group.calendar.feishu.cn（Claw日历）

默认时区： 亚洲/新加坡

快速参考

创建日历事件

node skills/lark-calendar/scripts/create-event.mjs \
  --title "Meeting with Team" \
  --description "Discuss Q2 roadmap" \
  --start "2026-02-03 14:00:00" \
  --end "2026-02-03 15:00:00" \
  --attendees "Boyang,RK" \
  --location "Meeting Room A"

参数：

更新日历事件

node skills/lark-calendar/scripts/update-event.mjs \
  --event-id "f9900f6b-b472-4b17-a818-7b5584abdc37_0" \
  --title "Updated Title" \
  --start "2026-02-03 15:00:00" \
  --end "2026-02-03 16:00:00"

删除日历事件

node skills/lark-calendar/scripts/delete-event.mjs \
  --event-id "f9900f6b-b472-4b17-a818-7b5584abdc37_0"

列出日历事件

# List events for next 7 days
node skills/lark-calendar/scripts/list-events.mjs

# List events in date range
node skills/lark-calendar/scripts/list-events.mjs \
  --start "2026-02-01" \
  --end "2026-02-28"

创建任务

node skills/lark-calendar/scripts/create-task.mjs \
  --title "Review PR #123" \
  --description "Code review for authentication module" \
  --due "2026-02-05 18:00:00" \
  --assignees "Boyang,jc"

参数：

更新任务

node skills/lark-calendar/scripts/update-task.mjs \
  --task-id "35fc5310-a1b1-49c7-be75-be631d3079ee" \
  --title "Updated Task" \
  --due "2026-02-06 18:00:00"

删除任务

node skills/lark-calendar/scripts/delete-task.mjs \
  --task-id "35fc5310-a1b1-49c7-be75-be631d3079ee"

管理活动参与者

# Add attendees
node skills/lark-calendar/scripts/manage-attendees.mjs \
  --event-id "xxx" --add "RK,jc"

# Remove attendees  
node skills/lark-calendar/scripts/manage-attendees.mjs \
  --event-id "xxx" --remove "jc"

管理任务成员

# Add members
node skills/lark-calendar/scripts/manage-task-members.mjs \
  --task-id "xxx" --add "RK,jc"

# Remove members
node skills/lark-calendar/scripts/manage-task-members.mjs \
  --task-id "xxx" --remove "jc"

员工目录

姓名会自动解析为飞书用户ID。支持的姓名格式：

业务规则

1. 博洋总是被添加为每个日历事件的参与者（自动）
2. 时区处理：使用IANA标识符（例如，亚洲/新加坡,亚洲/上海)
3. 时间格式：始终使用YYYY-MM-DD HH:MM:SS
4. user_id 与 open_id：此技能使用user_id格式（例如：dgg163e1），而非open_id（例如：ou_xxx）

编程使用

import { createEvent, updateEvent, deleteEvent } from './skills/lark-calendar/lib/calendar.mjs';
import { createTask, updateTask, deleteTask } from './skills/lark-calendar/lib/task.mjs';
import { resolveNames } from './skills/lark-calendar/lib/employees.mjs';

// Create event
const result = await createEvent({
  title: 'Team Sync',
  description: 'Weekly standup',
  startTime: '2026-02-03 10:00:00',
  endTime: '2026-02-03 10:30:00',
  attendeeIds: ['dgg163e1', 'gb71g28b'],
  location: 'Zoom',
  timezone: 'Asia/Singapore'
});

// Create task
const task = await createTask({
  title: 'Review document',
  description: 'Q2 planning doc',
  dueTime: '2026-02-05 18:00:00',
  assigneeIds: ['dgg163e1'],
  timezone: 'Asia/Singapore'
});

Lark API 参考

• 日历事件 API
• 日历参与者 API
• 任务 API

所需权限

请确保您的 Lark 应用拥有以下权限范围：

• calendar:calendar— 读写日历 ✅（已启用）
• calendar:calendar:readonly— 读取日历 ✅（已启用）
• task:task:write— 写入任务 ⚠️（需要添加以创建任务）
• task:task:read— 读取任务
• contact:user.employee_id:readonly— 读取用户信息 ✅（已启用）

添加权限：

1. 前往飞书开放平台
2. 添加权限：task:task:write、contact:contact:readonly（用于动态员工查找）
3. 重新发布应用版本

注意：如果没有contact:contact:readonly权限，该技能将使用静态备用员工列表。请更新lib/employees.mjs当团队发生变化时。