Feishu Calendar Skill
快速索引
| 用户意图 |
module |
tool_action |
必填参数 |
| 创建日程 |
calendar |
create |
title, start, duration |
| 查询日程 |
calendar |
query |
start, end |
| 更新日程 |
calendar |
update |
event_id + 要更新的字段 |
| 删除日程 |
calendar |
delete |
event_id |
| 列出日历 |
calendar |
list_calendars |
- |
| 查忙闲 |
calendar |
freebusy |
user_ids, start, end |
调用示例
创建日程
python3 skills/feishu-cli/run.py '{
"action": "tool",
"module": "calendar",
"tool_action": "create",
"title": "周会",
"start": "2026-03-10 10:00",
"duration": "60m",
"attendees": ["ou_xxx", "ou_yyy"],
"description": "每周同步进度"
}'
查询日程
python3 skills/feishu-cli/run.py '{
"action": "tool",
"module": "calendar",
"tool_action": "query",
"start": "2026-03-10",
"end": "2026-03-14"
}'
查忙闲
python3 skills/feishu-cli/run.py '{
"action": "tool",
"module": "calendar",
"tool_action": "freebusy",
"user_ids": ["ou_xxx", "ou_yyy"],
"start": "2026-03-10 09:00",
"end": "2026-03-10 18:00"
}'
核心约束
- 时间格式：支持
"2026-03-10 10:00" 或 ISO 8601 "2026-03-10T10:00:00+08:00"
- duration: 支持
"30m", "1h", "1h30m" 等格式
- attendees: 使用
open_id（ou_ 开头），数组格式
- 时区: 默认使用服务器时区，可通过
timezone 参数指定（如 "Asia/Shanghai"）
- 日历 ID: 大部分操作默认使用主日历，可通过
calendar_id 指定其他日历
- 重复日程: 使用
recurrence 参数（RRULE 格式），如 "FREQ=WEEKLY;BYDAY=MO"
常见错误
| 错误 |
原因 |
解决 |
| 无权限访问日历 |
未授权 calendar 相关 scope |
执行 OAuth 授权 |
| 参会人无法添加 |
user_id 格式错误 |
确认使用 open_id（ou_开头） |
| 时间冲突 |
目标时间段已有日程 |
先查询忙闲确认空闲 |
1---2name: feishu-calendar3description: When 飞书日历 events or meetings need managing → CRUD calendar events, manage attendees, query free/busy status.4---5
6# Feishu Calendar Skill
7
8## 快速索引
9
10| 用户意图 | module | tool_action | 必填参数 |
11|---------|--------|-------------|---------|
12| 创建日程 | calendar | create | title, start, duration |
13| 查询日程 | calendar | query | start, end |
14| 更新日程 | calendar | update | event_id + 要更新的字段 |
15| 删除日程 | calendar | delete | event_id |
16| 列出日历 | calendar | list_calendars | - |
17| 查忙闲 | calendar | freebusy | user_ids, start, end |
18
19## 调用示例
20
21### 创建日程
22
23```bash
24python3 skills/feishu-cli/run.py '{
25 "action": "tool",
26 "module": "calendar",
27 "tool_action": "create",
28 "title": "周会",
29 "start": "2026-03-10 10:00",
30 "duration": "60m",
31 "attendees": ["ou_xxx", "ou_yyy"],
32 "description": "每周同步进度"
33}'
34```
35
36### 查询日程
37
38```bash
39python3 skills/feishu-cli/run.py '{
40 "action": "tool",
41 "module": "calendar",
42 "tool_action": "query",
43 "start": "2026-03-10",
44 "end": "2026-03-14"
45}'
46```
47
48### 查忙闲
49
50```bash
51python3 skills/feishu-cli/run.py '{
52 "action": "tool",
53 "module": "calendar",
54 "tool_action": "freebusy",
55 "user_ids": ["ou_xxx", "ou_yyy"],
56 "start": "2026-03-10 09:00",
57 "end": "2026-03-10 18:00"
58}'
59```
60
61## 核心约束
62
63- **时间格式**：支持 `"2026-03-10 10:00"` 或 ISO 8601 `"2026-03-10T10:00:00+08:00"`
64- **duration**: 支持 `"30m"`, `"1h"`, `"1h30m"` 等格式
65- **attendees**: 使用 `open_id`（`ou_` 开头），数组格式
66- **时区**: 默认使用服务器时区，可通过 `timezone` 参数指定（如 `"Asia/Shanghai"`）
67- **日历 ID**: 大部分操作默认使用主日历，可通过 `calendar_id` 指定其他日历
68- **重复日程**: 使用 `recurrence` 参数（RRULE 格式），如 `"FREQ=WEEKLY;BYDAY=MO"`
69
70## 常见错误
71
72| 错误 | 原因 | 解决 |
73|------|------|------|
74| 无权限访问日历 | 未授权 calendar 相关 scope | 执行 OAuth 授权 |
75| 参会人无法添加 | user_id 格式错误 | 确认使用 open_id（ou_开头） |
76| 时间冲突 | 目标时间段已有日程 | 先查询忙闲确认空闲 |
cklxx