ai_member_xiaobian/.agents/skills/lark-task/references/lark-task-reminder.md

task +reminder

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules. Priority: For creating or modifying task reminder times, prioritize using this +reminder shortcut over other task update methods. It provides a more reliable and direct way to manage reminders.

Manage task reminders. Set new reminders or remove existing ones. Note that setting a task reminder requires a due date.

Recommended Commands

# Set a reminder (e.g., 30 minutes before due)
lark-cli task +reminder --task-id "<task_guid>" --set "30"

# Set a reminder (e.g., 1 hour before due)
lark-cli task +reminder --task-id "<task_guid>" --set "1h"

# Remove all reminders
lark-cli task +reminder --task-id "<task_guid>" --remove "true"

Parameters

Parameter	Required	Description
--task-id <guid>	Yes	The task GUID to modify. For Feishu task applinks, use the guid query parameter, not the suite_entity_num / display task ID like t104121.
--set <val>	No	Relative fire minutes before the due time. Supports numbers (e.g., 30) or units (e.g., 15m, 1h, 1d).
--remove <bool>	No	If set to true, removes all existing reminders from the task.

Workflow

1. Confirm the task and reminder action.
2. Execute the command.
3. Report success.

Caution

This is a Write Operation -- You must confirm the user's intent before executing.