Lark Calendar & Tasks

核心用法

Lark Calendar Skill 是一款面向飞书（Lark/Feishu）企业用户的日历与任务管理工具，提供完整的 CRUD 操作能力。核心功能包括：

• 日历事件管理：创建、更新、删除会议，支持设置标题、描述、起止时间、地点、时区及参会人
• 任务（Todo）管理：创建带截止日期的待办事项，支持指派给团队成员
• 员工目录集成：内置 20+ 员工的姓名-user_id 映射表，支持中英文别名自动解析（如 "Boyang/by/博洋" → dgg163e1）
• 参会人/成员管理：支持动态添加/移除会议参会人和任务成员

显著优点

1. 零配置上手：预设默认日历和时区（Asia/Singapore），提供静态员工目录，无需实时查询企业通讯录即可快速解析常用联系人
2. 智能名称解析：支持多别名映射（如 RK、jc、sagiri 等），降低记忆 user_id 的负担
3. 命令行与程序化双模式：既可通过 CLI 快速操作，也支持 ES Module 导入进行编程调用
4. 内置业务规则：自动将 Boyang 添加为所有日历事件的参会人，确保关键人员不错过会议

潜在缺点与局限性

1. 权限依赖较重：任务创建需额外申请 task:task:write 权限，动态员工查询需 contact:contact:readonly，否则降级为静态列表
2. 静态员工表维护成本：团队变动时需手动更新 lib/employees.mjs，存在信息滞后风险
3. 时区与格式严格：强制要求 IANA 时区标识和 YYYY-MM-DD HH:MM:SS 格式，对用户输入规范性要求高
4. 企业级锁定：深度绑定飞书生态，无法迁移至其他协作平台

适合人群

• 飞书企业用户，尤其是需要批量管理会议和任务的行政、项目经理
• 开发团队希望将日历操作集成到自动化工作流（CI/CD、机器人通知等）
• 中小团队（20-50人），员工变动不频繁的场景

常规风险

• 凭证泄露风险：FEISHU_APP_SECRET 存储于 .secrets.env，若版本控制配置不当可能导致密钥暴露
• 权限扩散：calendar:calendar 和 task:task:write 权限范围较宽，误操作可能影响他人日程
• 数据一致性：静态员工表与实际企业通讯录不同步时，可能导致邀请失败或误邀
• API 限流：高频调用可能触发飞书开放平台速率限制

概述

Lark Calendar Skill 是一个面向飞书（Lark/Feishu）企业用户的日历与任务自动化管理工具，由 Claw AI 官方开发，具备 S 级安全认证（CLS 评分 92/100）。该 Skill 提供完整的日历事件和任务管理功能，支持通过自然语言名称自动解析员工 ID，大幅降低企业内部协作工具的使用门槛。

核心用法

Skill 采用模块化设计，通过 Node.js 脚本提供 CLI 和程序化两种调用方式：

日历事件管理：创建、更新、删除事件，支持设置标题、时间、地点、参会人；所有事件自动添加 Boyang 作为参会人（业务规则）

任务管理：创建带截止日期的待办事项，指定执行人，支持成员增删操作

员工目录解析：内置静态员工映射表，支持多别名（如 "Boyang/by/博洋" 均指向同一用户），也可通过 Lark API 动态查询

典型工作流：

# 创建会议
node create-event.mjs --title "Q2 复盘" --start "2026-02-03 14:00:00" --attendees "RK,jc"

# 创建任务
node create-task.mjs --title "审核 PR" --due "2026-02-05 18:00:00" --assignees "启超"

显著优点

1. 企业级安全：通过 CocoLoop Safe 六维认证，敏感凭据环境变量隔离，HTTPS 通信，自动令牌刷新，符合 GDPR/SOC2/ISO27001

2. 零配置上手：预置默认日历和时区（Asia/Singapore），新员工可通过别名快速定位，无需记忆复杂 user_id

3. 双模式灵活调用：既支持命令行快速操作，也支持 ES Module 程序化集成

4. 官方 API 背书：基于 Lark Open Platform 官方 API，非逆向工程，稳定性有保障

5. 依赖极简：仅依赖 dotenv，无供应链攻击风险

局限性与风险

1. 静态员工目录：默认使用硬编码员工列表，团队变动时需手动更新；动态 API 查询需额外申请 contact:contact:readonly 权限

2. 权限配置门槛：Task 相关功能需手动在 Lark 开放平台申请 task:task:write 权限，新手可能遇到 403 错误

3. 时区与格式约束：强制要求 YYYY-MM-DD HH:MM:SS 格式，不支持相对时间描述（如 "明天下午3点"）

4. 单租户设计：绑定单一企业组织，不支持跨租户操作

适合人群

• 飞书企业版用户，需要批量管理日历或自动化会议安排
• 研发团队寻求将日程管理集成到 CI/CD 或内部工具链
• 行政/HR 人员需要快速创建周期性会议或跟踪任务分配

常规风险

• 数据误操作：删除事件/任务不可逆，建议配合操作审计日志（当前未内置，需自行实现）
• 令牌过期：虽然自动刷新，但极端情况下可能因网络波动导致临时 401 错误
• 权限蔓延：APP_SECRET 泄露可导致整租户数据访问，需严格保管 .secrets.env 文件

改进建议

• 将默认日历 ID 移至环境变量（当前硬编码）
• 添加操作确认机制，特别是删除命令
• 实现请求日志脱敏，避免敏感信息泄露到日志系统