lark-calendar

lark-calendar

Категория: Календарь и планирование

Создание, обновление и удаление событий календаря и задач в Lark (Feishu).

Описание

Этот навык предоставляет полный набор CRUD-операций для работы с:

• Событиями календаря — встречи, звонки, расписание
• Задачами (Todo) — действия с дедлайнами

Встроенный каталог сотрудников автоматически сопоставляет имена с user_id в Lark, избавляя от необходимости вручную искать внутренние идентификаторы.

Когда использовать

• Планирование командной встречи с участниками по имени
• Создание задачи с дедлайном и назначением исполнителей
• Обновление времени или места встречи
• Удаление отменённых событий из календаря
• Просмотр событий за заданный период

Настройка

Требуются следующие переменные окружения (в .secrets.env):

FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret

Календарь по умолчанию: Claw calendar
Часовой пояс по умолчанию: Asia/Singapore

Быстрый старт

Создание события

node skills/lark-calendar/scripts/create-event.mjs \
 --title "Meeting with Team" \
 --description "Discuss Q2 roadmap" \
 --start "2026-02-03 14:00:00" \
 --end "2026-02-03 15:00:00" \
 --attendees "Boyang,RK" \
 --location "Meeting Room A"

Параметры:

• --title — название события (обязательно)
• --description — описание
• --start — время начала (YYYY-MM-DD HH:MM:SS)
• --end — время окончания
• --attendees — имена участников (автоматически преобразуются в user_id)
• --attendee-ids — user_id напрямую
• --location — место
• --timezone — часовой пояс
• --calendar — ID календаря

Обновление события

node skills/lark-calendar/scripts/update-event.mjs \
 --event-id "event_id" \
 --title "Updated Title" \
 --start "2026-02-03 15:00:00" \
 --end "2026-02-03 16:00:00"

Удаление события

node skills/lark-calendar/scripts/delete-event.mjs \
 --event-id "event_id"

Просмотр событий

# События на ближайшие 7 дней
node skills/lark-calendar/scripts/list-events.mjs

# События за период
node skills/lark-calendar/scripts/list-events.mjs \
 --start "2026-02-01" \
 --end "2026-02-28"

Создание задачи

node skills/lark-calendar/scripts/create-task.mjs \
 --title "Review PR #123" \
 --description "Code review for authentication module" \
 --due "2026-02-05 18:00:00" \
 --assignees "Boyang,jc"

Параметры:

• --title — название задачи (обязательно)
• --description — описание
• --due — дедлайн
• --assignees — исполнители (имена)
• --assignee-ids — user_id напрямую
• --timezone — часовой пояс

Обновление задачи

node skills/lark-calendar/scripts/update-task.mjs \
 --task-id "task_id" \
 --title "Updated Task" \
 --due "2026-02-06 18:00:00"

Удаление задачи

node skills/lark-calendar/scripts/delete-task.mjs \
 --task-id "task_id"

Пример использования

Запрос пользователя: Запланировать встречу «Q2 Planning» на завтра в 14:00 с RK и Dodo

• Определение user_id для RK и Dodo
• Расчёт даты и времени
• Создание события через create-event
• Возврат ID события и подтверждение участников

Результат: событие успешно создано с указанными участниками

Требования

Для работы необходимы:

• Приложение Lark с доступами к календарю и задачам
• FEISHU_APP_ID и FEISHU_APP_SECRET
• Разрешения: calendar и task API