飞书日历管理

技能简介

该技能用于管理飞书（Lark）日历，支持列出日历列表、搜索特定日历、查看日程状态以及执行事件同步操作。

业务背景

解决企业跨系统日程管理难题，让业务人员无需切换飞书后台即可统一查看团队日历状态。通过自动同步避免会议冲突，确保项目排期信息实时一致，降低人工核对成本，提升协作效率。

落地案例：项目经理需要协调产品、研发、设计三方周会时间。使用该技能输入各部门共享日历名称，快速检索出所有相关日历ID及忙闲状态，筛选出共同空闲时段后创建会议，并同步至本地项目管理台账，实现排期信息一站式维护。

能做什么

• 列出所有可用日历及其ID
• 按名称或摘要搜索日历
• 检查指定日历的当前状态
• 将日历事件同步到本地状态
• 创建任务提醒并自动设置参与者
• 创建共享日历并配置成员权限

使用说明

安装准备

1. 克隆技能仓库到本地目录
2. 在项目根目录创建 .env 文件
3. 配置环境变量：FEISHU_APP_ID 和 FEISHU_APP_SECRET

基础操作

列出日历：

node skills/feishu-calendar/list_test.js

搜索日历：

node skills/feishu-calendar/search_cal.js

检查主日历状态：

node skills/feishu-calendar/check_master.js

执行同步：

node skills/feishu-calendar/sync_routine.js

任务标记协议

当用户说”标记这个任务”或”提醒我…”时：

1. 解析日期时间（如”2月4日”转换为 YYYY-MM-04）
2. 运行创建命令，将请求者设为参与者

node skills/feishu-calendar/create.js --summary "Task: <标题>" --desc "<上下文>" --start "<ISO时间>" --end "<ISO+1小时>" --attendees "<用户ID>"

创建共享日历

node skills/feishu-calendar/setup_shared.js --name "项目名称" --desc "描述" --members "ou_1,ou_2" --role "writer"

输入与输出

见下方输入与输出表格。

项目	内容
输入	飞书应用凭证（APP_ID/APP_SECRET）、日历查询条件、任务元数据（标题/时间/参与者）、共享日历配置参数
输出	日历列表、日程状态、同步确认、新建事件详情、共享日历创建结果
适用人群	飞书企业用户、开发运维人员、需要日历自动化集成的团队
不包含	飞书审批、文档协作、多平台日历互通、图形界面操作

 

风险提示

• 需妥善保管 FEISHU_APP_SECRET，避免泄露导致数据风险
• 同步操作可能覆盖本地状态，建议先备份重要数据
• 创建事件时需确认时间格式为ISO标准，否则可能解析失败
• 共享日历的成员ID需提前获取，错误ID会导致邀请失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/autogame-17/feishu-calendar/SKILL.md
来源类型：GitHub 开源仓库