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-calendar
3description: When 飞书日历 events or meetings need managing → CRUD calendar events, manage attendees, query free/busy status.
4triggers:
5 intent_patterns:
6 - "日历|日程|calendar|会议|meeting"
7 - "创建日程|安排会议|查看日历|空闲时间|忙闲"
8 - "约.*时间|book.*time|找.*空闲|find.*available"
9 - "今天.*有什么.*会|what.*meetings.*today|明天.*日程|tomorrow.*schedule"
10 - "取消.*会议|cancel.*meeting|改.*时间|reschedule"
11 - "邀请.*参加|invite.*to|添加.*参会人|add.*attendee"
12 - "下周.*安排|next.*week.*schedule|这周.*日程|this.*week"
13 context_signals:
14 keywords: ["calendar", "日历", "日程", "会议", "event", "attendee", "freebusy", "约", "安排", "空闲", "取消", "邀请", "schedule"]
15 confidence_threshold: 0.5
16priority: 9
17requires_tools: [bash]
18max_tokens: 300
19cooldown: 15
20metadata:
21 source: https://skillmd.com/skills/cklxx/feishu-calendar
22---
23
24# Feishu Calendar Skill
25
26## 快速索引
27
28| 用户意图 | module | tool_action | 必填参数 |
29|---------|--------|-------------|---------|
30| 创建日程 | calendar | create | title, start, duration |
31| 查询日程 | calendar | query | start, end |
32| 更新日程 | calendar | update | event_id + 要更新的字段 |
33| 删除日程 | calendar | delete | event_id |
34| 列出日历 | calendar | list_calendars | - |
35| 查忙闲 | calendar | freebusy | user_ids, start, end |
36
37## 调用示例
38
39### 创建日程
40
41```bash
42python3 skills/feishu-cli/run.py '{
43 "action": "tool",
44 "module": "calendar",
45 "tool_action": "create",
46 "title": "周会",
47 "start": "2026-03-10 10:00",
48 "duration": "60m",
49 "attendees": ["ou_xxx", "ou_yyy"],
50 "description": "每周同步进度"
51}'
52```
53
54### 查询日程
55
56```bash
57python3 skills/feishu-cli/run.py '{
58 "action": "tool",
59 "module": "calendar",
60 "tool_action": "query",
61 "start": "2026-03-10",
62 "end": "2026-03-14"
63}'
64```
65
66### 查忙闲
67
68```bash
69python3 skills/feishu-cli/run.py '{
70 "action": "tool",
71 "module": "calendar",
72 "tool_action": "freebusy",
73 "user_ids": ["ou_xxx", "ou_yyy"],
74 "start": "2026-03-10 09:00",
75 "end": "2026-03-10 18:00"
76}'
77```
78
79## 核心约束
80
81- **时间格式**:支持 `"2026-03-10 10:00"` 或 ISO 8601 `"2026-03-10T10:00:00+08:00"`
82- **duration**: 支持 `"30m"`, `"1h"`, `"1h30m"` 等格式
83- **attendees**: 使用 `open_id`(`ou_` 开头),数组格式
84- **时区**: 默认使用服务器时区,可通过 `timezone` 参数指定(如 `"Asia/Shanghai"`)
85- **日历 ID**: 大部分操作默认使用主日历,可通过 `calendar_id` 指定其他日历
86- **重复日程**: 使用 `recurrence` 参数(RRULE 格式),如 `"FREQ=WEEKLY;BYDAY=MO"`
87
88## 常见错误
89
90| 错误 | 原因 | 解决 |
91|------|------|------|
92| 无权限访问日历 | 未授权 calendar 相关 scope | 执行 OAuth 授权 |
93| 参会人无法添加 | user_id 格式错误 | 确认使用 open_id(ou_开头) |
94| 时间冲突 | 目标时间段已有日程 | 先查询忙闲确认空闲 |