飞书日程智能管家

Claw AI 官方出品的飞书日历与任务管理技能，支持自动化日程创建、成员邀请与任务分配，助力团队高效协同办公。

基本信息

• 技能名称?lark-calendar
• 中文名称?飞书日程智能管家
• 作者?boyangwang
• 分类?办公
• 版本?v1.0.0
• 标签?office, productivity, automation, api, project-program-management

使用方法

使用说明
核心用法
Lark Calendar Skill 是一款面向飞书（Lark/Feishu）生态的企业级日程管理工具，提供完整的日历事件与任务（Todo）CRUD 操作能力。用户可通过命令行脚本或程序化 API 两种方式调用：命令行模式适合快速创建会议、批量管理任务；程序化模式则便于集成到自动化工作流中。
核心功能覆盖六大场景：日历事件的增删改查、任务的全生命周期管理、事件参与者动态增减、任务成员分配、员工姓名自动解析（支持 20+ 位内部成员的别名映射），以及时区智能处理（默认 Asia/Singapore，支持 IANA 标准时区）。特别值得注意的是，系统会自动将 Boyang（老板）添加为所有日历事件的参与者，确保管理层信息同步。
显著优点
深度生态集成 ：直接对接飞书开放平台官方 API，而非模拟浏览器操作，稳定性与合规性兼具。员工目录功能尤为实用——支持 "Boyang/by/博洋" 等多别名自动解析为 user_id，大幅降低人工查找成本。
双模式灵活调用 ：既提供 8 个即开即用的 CLI 脚本（create-event、update-task、manage-attendees 等），也暴露模块化 JavaScript API，方便嵌入 CI/CD 流水线或内部管理系统。
企业级细节设计 ：内置 Token 自动缓存与 5 分钟过期缓冲机制，避免频繁调用认证接口；强制 HTTPS 通信；敏感配置隔离至 .secrets.env 文件，符合十二要素应用规范。
潜在缺点与局限性
权限配置门槛 ：任务创建需额外申请 task:task:write 权限，且员工动态查询依赖 contact:contact:readonly ，否则回退至静态名单。对于人员流动频繁的团队，需手动维护 lib/employees.mjs 文件。
时区与格式约束 ：时间格式严格限定为 YYYY-MM-DD HH:MM:SS ，不支持自然语言输入（如 "明天下午三点"）；时区虽可配置，但缺乏智能识别能力。
单租户架构 ：默认日历与员工目录均为 Claw AI 内部配置，外部企业 fork 后需深度改造才能复用，通用性受限。
适合的目标群体
已部署飞书作为协同平台的中小型企业技术团队
需要自动化会议安排、任务分发的 DevOps/运维工程师
追求"代码即文档"、偏好 CLI 工作流的技术管理者
希望将日程管理集成到内部 Bot 或自动化脚本中的开发者
使用风险
密钥泄露风险 ： FEISHU_APP_SECRET 存储于本地文件，若权限配置不当（未设 600）或误提交至 Git，可能导致企业数据泄露。建议配合 git-secrets 等工具做提交前检查。
API 限流风险 ：飞书开放平台对日历、任务接口有 QPS 限制，批量操作（如一次性创建数十个任务）可能触发限流，需自行实现退避重试逻辑。
数据误操作风险 ：删除事件/任务为不可逆操作，且 CLI 无二次确认交互，脚本化批量删除时需谨慎测试。
依赖单一供应商 ：深度绑定飞书生态，若企业迁移至钉钉、企业微信或其他平台，需完全重写集成层。