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_开头） |
| 时间冲突 | 目标时间段已有日程 | 先查询忙闲确认空闲 |