القائمة
飞书日历日程管理。用于创建、查看、更新、删除日程，邀请参会人。当用户提到会议（会议/开会）、日程（日程/排期）、日历、约时间、邀请人时触发。日历回答「什么时候在哪做什么」——需要到场的时间锚定事件。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
ArXiv 论文搜索、追踪与摘要。搜索论文、获取最新论文、查看论文详情。
飞书多维表格管理。用于创建应用、查看表格、查询/新增/更新/删除记录（支持筛选）。当用户提到多维表格、数据表、结构化数据、查询/更新表格记录时触发。注意：普通电子表格（单元格操作）用 feishu-sheet，多维表格是带类型字段和视图的数据库。
联系人管理与解析（contacts/联系人/通讯录）。用于查找用户 open_id（谁是XX/XX的open_id）、管理联系人别名（记住XX是XX）、跨 skill 共享联系人信息。自动从 API 响应中学习联系人映射。
飞书文档（结构化沟通）。用于创建文档（写个文档/建个文档）、整理讨论结果、读取飞书文档链接、保存内容到文档、查看/回复文档评论。输出超过 1000 字且涉及多维度时自动触发（用文档而非聊天刷屏），方案讨论优先用文档（支持评论批注）。
飞书云盘/云空间管理。用于列出文件/文件夹、创建文件夹、移动/删除文件、搜索。当用户提到云盘、文件管理、文件夹、整理文件、找文件时触发。注意：读写文档内容用 feishu-doc，云盘管理文件树。
飞书文档权限管理。用于添加/移除协作者、设置公开分享、检查访问级别。当用户提到分享（分享/共享）、权限、协作者、访问控制、链接分享、「把文档分享给XX」时触发。注意：创建/编辑文档内容用 feishu-doc。
| name | feishu-cal |
| description | 飞书日历日程管理。用于创建、查看、更新、删除日程，邀请参会人。当用户提到会议（会议/开会）、日程（日程/排期）、日历、约时间、邀请人时触发。日历回答「什么时候在哪做什么」——需要到场的时间锚定事件。 |
Bot 拥有独立日历，创建的日程用户可见。涉及用户的事件必须将用户加为 attendee 才能同步到用户日历。
与 feishu-task 的边界：日历管理时间锚点（有开始/结束、需要"在场"的事件），任务管理承诺追踪（有状态流转、需要"做完"的事项）。重叠时：如"周三 14:00 面试候选人"建日历事件，如果还有准备工作（"面试前看简历"）额外建任务。
所有时间参数均使用 Asia/Shanghai 时区。
| 格式 | 示例 | 说明 |
|---|---|---|
| ISO | 2026-03-03T10:00 | 标准格式，首选 |
| 日期+时间 | 2026-03-03 10:00 | 等同于 ISO |
| 仅时间 | 14:00 | 今天该时刻；若已过则顺延到明天 |
| tomorrow | tomorrow 10:00 | 明天指定时刻 |
| 相对偏移 | +2h / +30m | 从当前时刻起偏移 |
cd ~/Agent\ Space/agentic-feishu && python3 tools/builtin/skill_cal.py <action> --params '<json>'
示例：
python3 tools/builtin/skill_cal.py list --params '{"days": 7}'
调用方式：python3 tools/builtin/skill_cal.py <action> --params '<json>'
create — 创建日程。params: {summary, start_time, end_time, description?, attendees?}。必须将请求用户（消息上下文中的 open_id）加为参会人，确保日程出现在用户日历中。创建后必须告知用户（标题 + 时间）。attendees 接受：CSV 字符串、字符串列表、或字典列表（自动提取 open_id），代码自动归一化为字符串列表。
list — 列出近期日程。params: {days?=7}。返回未来 N 天的事件列表。
update — 更新日程。params: {event_id, summary?, start_time?, end_time?, description?}。只传需要修改的字段。不支持通过 update 修改参会人，必须用 add_attendees / remove_attendees。
delete — 删除日程。params: {event_id, confirmed?}。两阶段确认：第一次调用（不传 confirmed 或 confirmed=false）返回确认提示，不执行删除；第二次调用传 confirmed=true 才真正删除。
freebusy — 查询空闲/忙碌状态。params: {start_time, end_time, user_ids?}。user_ids 为逗号分隔的 open_id 字符串或列表；不传则查 Bot 自身日历。
list_attendees — 列出日程参会人。params: {event_id}。返回参会人列表，含 attendee_id（记录 ID）、user_id（open_id）、display_name、status。
add_attendees — 添加参会人到已有日程。params: {event_id, attendee_ids}。attendee_ids 为 open_id（逗号分隔字符串或列表）。
remove_attendees — 移除日程参会人。params: {event_id, attendee_ids}。CRITICAL：attendee_ids 必须是 list_attendees 返回的 attendee_id（内部记录 ID），不是 open_id。必须先调 list_attendees 获取正确 ID。
以下由 Python 代码自动处理，无需在调用时特殊处理：
attendees / attendee_ids 传入字符串、字典、或混合列表均自动提取为 open_id 字符串列表；CSV 字符串自动拆分freebusy 的 user_ids 传逗号分隔字符串时自动拆分为列表delete 未传 confirmed=true 时只返回提示文本，不触发 API 调用# 创建日程，邀请两位参会人
feishu_cal("create", {"summary": "周会", "start_time": "2026-03-03T10:00", "end_time": "2026-03-03T11:00", "attendees": ["ou_xxx", "ou_yyy"]})
# 列出未来 3 天日程
feishu_cal("list", {"days": 3})
# 删除日程（第二阶段，已确认）
feishu_cal("delete", {"event_id": "xxx", "confirmed": true})
# 移除参会人（attendee_ids 来自 list_attendees 的 attendee_id 字段，非 open_id）
feishu_cal("remove_attendees", {"event_id": "xxx", "attendee_ids": "attendee_record_id_1,attendee_record_id_2"})
update 不支持修改参会人，需单独调 add_attendees / remove_attendeesremove_attendees 必须用 attendee_id（记录 ID），误传 open_id 会失败，必须先 list_attendees