alextangson/feishu_skills/feishu-calendar

Claude Code and agent skill by alextangson/feishu_skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

飞书日历。创建日程、查询日程、更新日程。

Install

npx vskill@latest install alextangson/feishu_skills/feishu-calendar

SKILL.md

飞书日历

通过 Calendar API 管理日程。

Base URL: https://open.feishu.cn/open-apis/calendar/v4

认证与 Token 获取

从 feishu_skills 根目录执行共享脚本：

bash
TOKEN="$(./scripts/get_feishu_token.sh)"

请求头统一使用 Authorization: Bearer ${TOKEN}。

如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求：

bash
TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"

环境变量:

  • FEISHU_APP_ID
  • FEISHU_APP_SECRET

本地缓存: ./.feishu_token_cache.json（未过期直接复用，默认提前 5 分钟刷新）

日程操作

API端点方法请求体示例说明
创建日程/calendars/{calendar_id}/eventsPOST{"summary":"会议标题","start_time":{"timestamp":"1770508800"},"end_time":{"timestamp":"1770512400"}}创建新日程
获取日程/calendars/{calendar_id}/events/{event_id}GET-查询日程详情
更新日程/calendars/{calendar_id}/events/{event_id}PATCH{"summary":"新标题"}修改日程
删除日程/calendars/{calendar_id}/events/{event_id}DELETE-删除日程
搜索日程/calendars/{calendar_id}/events/searchPOST{"query":"关键词","start_time":{"timestamp":"1770508800"}}条件搜索
获取日程列表/calendars/{calendar_id}/eventsGET-查询日历下所有日程

创建日程:

json
{
  "summary": "会议标题",
  "start_time": {"timestamp": "1770508800"},
  "end_time": {"timestamp": "1770512400"},
  "attendees": [{"type": "user", "attendee_id": "ou_xxx"}]
}

attendees type: user / chat / resource(会议室)

日程参与人

API端点方法请求体示例说明
获取参与人/calendars/{calendar_id}/events/{event_id}/attendeesGET-查询参与人列表
添加参与人/calendars/{calendar_id}/events/{event_id}/attendeesPOST{"attendees":[{"type":"user","attendee_id":"ou_xxx"}]}邀请参与人
删除参与人/calendars/{calendar_id}/events/{event_id}/attendees/{attendee_id}DELETE-移除参与人
获取参与群成员/calendars/{calendar_id}/events/{event_id}/attendees/chat_membersGET-查询群参与成员

日历管理

API端点方法请求体示例说明
获取日历列表/calendarsGET查询参数：page_size=50&page_token=xxx查询所有日历（分页）
获取主日历/calendars/primaryGET-查询用户主日历
创建日历/calendarsPOST{"summary":"日历名称","description":"描述","permissions":"public"}创建共享日历
获取日历/calendars/{calendar_id}GET-查询日历详情
更新日历/calendars/{calendar_id}PATCH{"summary":"新名称"}修改日历
删除日历/calendars/{calendar_id}DELETE-删除日历
搜索日历/calendars/searchPOST{"query":"关键词"}搜索日历

日历订阅与 ACL

API端点方法请求体示例说明
获取 ACL 列表/calendars/{calendar_id}/aclsGET-查询日历权限
创建 ACL/calendars/{calendar_id}/aclsPOST{"role":"reader","scope":{"type":"user","user_id":"ou_xxx"}}添加权限
删除 ACL/calendars/{calendar_id}/acls/{acl_id}DELETE-移除权限
订阅日历/calendars/{calendar_id}/subscribePOST-订阅日历变更
取消订阅/calendars/{calendar_id}/unsubscribePOST-取消日历订阅
订阅日程事件/calendars/{calendar_id}/events/subscribePOST-订阅日程变更
取消日程订阅/calendars/{calendar_id}/events/unsubscribePOST-取消日程订阅

ACL role: none / free_busy_reader / reader / writer / owner

会议室管理

API端点方法请求体示例说明
获取会议室列表/roomsGET-查询所有会议室
获取会议室/rooms/{room_id}GET-查询会议室详情
查询会议室忙闲/rooms/{room_id}/freebusyGET-查询会议室可用时间
创建日程并占用会议室

占用会议室的关键：在 attendees 中添加 type: "resource" 的参与人，attendee_id 填会议室的 room_id。

完整流程：

bash
# 1. 获取会议室列表，拿到 room_id
curl -X GET "https://open.feishu.cn/open-apis/calendar/v4/rooms?page_size=50" \
  -H "Authorization: Bearer YOUR_TOKEN"
 
# 2. （可选）查询会议室在目标时间段是否空闲
curl -X GET "https://open.feishu.cn/open-apis/calendar/v4/rooms/{room_id}/freebusy?start_time=1770508800&end_time=1770512400" \
  -H "Authorization: Bearer YOUR_TOKEN"
 
# 3. 创建日程，attendees 中加入会议室
curl -X POST "https://open.feishu.cn/open-apis/calendar/v4/calendars/primary/events" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "summary": "团队会议",
    "start_time": {"timestamp": "1770508800"},
    "end_time": {"timestamp": "1770512400"},
    "attendees": [
      {"type": "user", "attendee_id": "ou_xxx"},
      {"type": "resource", "attendee_id": "omcxxxxxxxxxxxxx"}
    ]
  }'

⚠️ 若会议室在该时段已被占用，创建请求会返回冲突错误，请先查询忙闲再预订。

常见参数说明

时间格式:

  • timestamp: 秒级时间戳（如 "1770508800"）
  • date: 日期字符串（如 "2026-03-07"）

分页参数:

  • page_size: 每页数量（默认 50，最大 500）
  • page_token: 分页标记（从上次响应获取）

user_id_type: 用户 ID 类型

  • open_id（默认）
  • user_id
  • union_id

测试示例

获取日历列表:

bash
curl -X GET "https://open.feishu.cn/open-apis/calendar/v4/calendars?page_size=10" \
  -H "Authorization: Bearer ${TOKEN}"

创建日程:

bash
curl -X POST "https://open.feishu.cn/open-apis/calendar/v4/calendars/primary/events" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "summary": "团队会议",
    "start_time": {"timestamp": "1709798400"},
    "end_time": {"timestamp": "1709802000"}
  }'

最佳实践

  1. 时间用秒级时间戳
  2. attendees 指定类型（user/chat/resource）
  3. 分页查询：大量数据用 page_token 分页
  4. 主日历：用户个人日历用 primary 作为 calendar_id

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
62
Repository forks
6
7-day trend score
21

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 19 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/alextangson/feishu_skills/feishu-calendar/badge)](https://verified-skill.com/skills/alextangson/feishu_skills/feishu-calendar)

Something wrong with this skill or its page? Tell us.