feishu-calendar

Manage Feishu (Lark) Calendars. Use this skill to list calendars, check schedules, and sync events.

Usage

List Calendars

Check available calendars and their IDs.

node skills/feishu-calendar/list_test.js

Search Calendar

Find a calendar by name/summary.

node skills/feishu-calendar/search_cal.js

Check Master's Calendar

Specific check for the Master's calendar status.

node skills/feishu-calendar/check_master.js

Sync Routine

Run the calendar synchronization routine (syncs events to local state/memory).

node skills/feishu-calendar/sync_routine.js

Setup

Requires FEISHU_APP_ID and FEISHU_APP_SECRET in .env.

Standard Protocol: Task Marking

Trigger: User says "Mark this task" or "Remind me to...". Action:

1. Analyze: Extract date/time (e.g., "Feb 4th" -> YYYY-MM-04).
2. Execute: Run create.js with --attendees set to the requester's ID.
3. Format:

   node skills/feishu-calendar/create.js --summary "Task: <Title>" --desc "<Context>" --start "<ISO>" --end "<ISO+1h>" --attendees "<User_ID>"
   

Setup Shared Calendar

Create a shared calendar for a project and add members.

node skills/feishu-calendar/setup_shared.js --name "Project Name" --desc "Description" --members "ou_1,ou_2" --role "writer"

🚀 30 秒快速开始

# 基础用法
# TODO: 添加具体命令示例

📋 何时使用

当以下情况时使用此技能：

1. 场景 1
2. 场景 2
3. 场景 3

🔧 配置

必需配置

# 环境变量或配置文件

可选配置

# 可选参数

💡 实际应用场景

场景 1: 基础用法

# 命令示例

场景 2: 进阶用法

# 命令示例

🧪 测试

# 运行测试
python3 scripts/test.py

⚠️ 故障排查

常见问题

问题： 描述问题

解决方案：

# 解决步骤

📚 设计原则

本技能遵循 Karpathy 的极简主义设计哲学：

1. 单一职责 - 只做一件事，做好
2. 清晰可读 - 代码即文档
3. 快速上手 - 30 秒理解用法
4. 最小依赖 - 只依赖必要的库
5. 教育优先 - 详细的注释和示例

最后更新：2026-03-16 | 遵循 Karpathy 设计原则

🏷️ 质量标识

备注: 本技能已在 2026-03-16 批量优化中完成优化，遵循 Karpathy 设计原则。