Claw AI 官方出品的飞书日历与任务管理技能，支持自动化日程创建、成员邀请与任务分配，助力团队高效协同办公。
说明：
## 核心用法
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 无二次确认交互，脚本化批量删除时需谨慎测试。
**依赖单一供应商**：深度绑定飞书生态，若企业迁移至钉钉、企业微信或其他平台，需完全重写集成层。
会员专属
