Feishu Calendar Advanced

核心用法

Feishu Calendar Advanced 是一个基于 feishu-agent CLI 的飞书日历管理工具，封装了飞书开放平台的日历接口，提供以下核心能力：

| 功能模块 | 具体能力 |

|---------|---------|

| 日历浏览 | `calendars` 命令列出所有主日历和订阅日历 |

| 日程查询 | `events` 命令查看主日历中的日程列表 |

| 日程创建 | `create` 命令支持指定标题、起止时间、添加参会人 |

| 日程删除 | `delete` 命令按事件 ID 删除指定日程 |

| 冲突检测 | 创建日程时自动检测时间冲突并提示 |

使用前提：需先完成 feishu-agent 的三步配置：① 安装并配置应用 ID/Secret ② OAuth 授权 ③ 验证身份。

技术实现特点

• 底层依赖 @teamclaw/feishu-agent 包，通过 bunx 动态执行
• 支持跨平台运行（Darwin/Linux）
• 命令行参数设计遵循 POSIX 风格，支持多参会人重复传参

显著优点

1. 企业级集成：直接对接飞书开放平台，与飞书原生日历体验一致
2. 冲突智能提示：创建日程时自动检测时间冲突，避免重复预约
3. 参会人管理：支持通过 user_id 批量添加参会人，适合会议场景
4. 轻量部署：仅需 bun 运行时，无需复杂环境配置
5. Token 自动管理：内置授权刷新机制，降低凭证过期导致的故障

潜在局限与风险

| 局限项 | 说明 |

|-------|------|

| 凭证依赖重 | 必须预先在飞书开发者平台创建应用并获取 `appId`/`appSecret`，个人用户门槛较高 |

| 时间格式严格 | 仅支持 `"YYYY-MM-DD HH:MM"` 格式，无时区处理说明，跨时区团队需谨慎 |

| 权限粒度粗 | 需要 `calendar:calendar` 和 `calendar:event` 两项权限，无法细粒度控制只读/读写 |

| 无日历订阅管理 | 仅能查看已订阅的日历，无法通过命令行订阅/取消订阅新日历 |

| 参会人限制 | 需预先知道对方 `user_id`，不支持通过邮箱/手机号邀请 |

常规风险

• 授权过期风险：OAuth Token 有效期有限，需定期重新授权
• 数据误删风险：delete 命令无二次确认机制，删除后不可恢复
• 权限泄露风险：appSecret 以明文形式存储在本地配置中，多用户环境需注意隔离
• API 限流风险：高频调用可能触发飞书开放平台频率限制

适合人群

• 已部署飞书企业版的团队管理员或开发者
• 需要将日历操作自动化集成到 CI/CD 或内部工作流的工程师
• 习惯命令行操作、追求效率的飞书重度用户
• 需要批量创建会议日程的行政/项目管理角色

与通用日历工具对比

| 维度 | 本工具 | 通用 CalDAV 工具 |

|-----|-------|---------------|

| 认证方式 | OAuth 2.0 + 应用凭证 | 用户名密码/Token |

| 冲突检测 | ✅ 原生支持 | 依赖客户端实现 |

| 参会人管理 | ✅ 支持企业组织架构 | 通常仅支持邮件邀请 |

| 部署复杂度 | 中等（需飞书应用配置） | 较低 |

| 企业合规性 | ✅ 符合飞书审计要求 | 视具体工具而定 |

核心用法

feishu-calendar-advanced 是一款面向飞书（Lark）用户的日历管理技能，通过调用 @teamclaw/feishu-agent CLI 工具实现对飞书日历的完整操作。用户可通过简洁的命令行指令完成日历列表查看、事件查询、日程创建与删除等核心功能。

使用前需完成三步初始化：安装 Bun 运行时、配置应用凭证（appId/appSecret）、执行 OAuth 授权。授权成功后，即可通过 /feishu-calendar-advanced 前缀调用各项命令。创建事件时支持指定标题、起止时间及参会人，系统会自动检测时间冲突并给出提示。

显著优点

生态原生集成：深度对接飞书开放平台，利用官方日历 API（calendar:calendar、calendar:event 权限）确保功能稳定性与数据一致性，避免第三方 scraping 方案的风险。

纯文档安全架构：本 Skill 本身为零代码纯 Markdown 文档，无可执行文件、无网络请求逻辑，所有实际操作均由外部 CLI 代理完成，从根本上杜绝代码注入与恶意执行风险。

冲突智能检测：创建事件时自动校验时间冲突，防止日程重叠，提升团队协作效率。

多端兼容：基于 Bun 运行时，支持 macOS（Darwin）与 Linux 双平台，满足开发机与服务器部署场景。

潜在缺点与局限性

外部依赖风险：实际功能完全依赖 @teamclaw/feishu-agent 包，该社区包的维护状态、版本兼容性及长期支持存在不确定性。若该包停止维护或引入 breaking change，将导致 Skill 失效。

配置门槛较高：需预先申请飞书开放平台应用、获取 appId/appSecret、完成 OAuth 授权流程，对非技术人员不够友好。

功能边界受限：仅支持基础 CRUD 操作，缺乏循环日程、会议室预订、日程提醒自定义等高级功能；参会人需通过 user_id 指定，无法直接解析邮箱或姓名。

网络与权限依赖：所有操作需实时连接飞书服务器，离线场景不可用；企业级部署可能受限于管理员权限策略。

适合的目标群体

• 企业行政与运维人员：需批量管理团队日历、自动化会议安排的场景。
• 研发团队与项目经理：习惯命令行工具、追求日程管理自动化的高级用户。
• 飞书深度用户：已接入飞书生态、希望打通 IM 与日历数据的工作流优化者。
• 自动化集成开发者：需将日历操作嵌入 CI/CD 或内部脚本系统的技术团队。

使用风险说明

授权安全风险：OAuth 令牌存储于本地，若设备丢失或多人共用环境，存在令牌泄露风险。建议定期执行 auth 刷新令牌，并在离职或设备变更时及时撤销授权。

误操作风险：delete 命令直接永久删除事件，无回收站机制；跨时区场景下时间格式解析错误可能导致会议时间偏差。建议重要操作前通过 events 命令二次确认。

依赖可用性风险：@teamclaw/feishu-agent 为社区个人项目，无 SLA 保障。生产环境使用前应进行源代码审计，并考虑锁定版本号（bunx @teamclaw/feishu-agent@x.x.x）。

数据合规提示：本 Skill 本身不收集用户数据，但飞书平台可能依据服务条款处理日历元数据。涉及敏感业务会议的企业用户应评估飞书云端数据存储策略是否符合内部合规要求。