ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
3.3 KiB
task +get-my-tasks
If the user query only specifies a task name (e.g., "Complete task Lobster No. 1"), use this command to list and search for the task by its summary.
Prerequisites: Please read
../lark-shared/SKILL.mdto understand authentication, global parameters, and security rules.⚠️ Note: This API must be called with a user identity. Do NOT use an app identity, otherwise the call will fail.
Output rendering note:
- If you need to present user fields (assignee, creator, etc.), do not only output the raw
id(e.g. open_id). Also try to resolve and display the user's real name (e.g. via the contact skill) for readability.- When rendering timestamps (e.g. created time, due time), use the local timezone. Format is 2006-01-02 15:04:05
List tasks assigned to the current user, with support for filtering by completion status, creation time, and due date.
By default, the command will automatically paginate up to 20 times. Use --page-all to fetch more (up to 40 pages).
Pending vs all tasks: When
--completeis not provided, the result contains both completed and incomplete tasks. For standup / daily-summary / pending-todo scenarios, you must pass--complete=false; otherwise completed tasks will be surfaced as if they were still pending.
Recommended Commands
# Search for a specific task by name
lark-cli task +get-my-tasks --query "Lobster No. 1"
# Get all my tasks, both completed and incomplete (fetches up to 20 pages by default)
lark-cli task +get-my-tasks
# Pending-only: my incomplete tasks (use this for standup/daily-summary)
lark-cli task +get-my-tasks --complete=false
# Pending-only with a due-date upper bound (e.g. end of today / this week)
lark-cli task +get-my-tasks --complete=false --due-end "2026-03-27T23:59:59+08:00"
# Fetch all my tasks (up to 40 pages)
lark-cli task +get-my-tasks --page-all
# Fetch up to 10 pages
lark-cli task +get-my-tasks --page-limit 10
# Resume from a known page token
lark-cli task +get-my-tasks --page-token "pt_xxx"
Parameters
| Parameter | Required | Description |
|---|---|---|
--query <string> |
No | Search for tasks by summary. Returns exact matches if any; otherwise returns partial matches. |
--complete=<bool> |
No | Optional. If not provided, it fetches all tasks (both incomplete and completed). Set to true to fetch only completed tasks, or false for incomplete tasks. |
--created_at <string> |
No | Query tasks created after this time. Supports date: YYYY-MM-DD, relative: -2d, or ms timestamp. |
--due-start <string> |
No | Query tasks with a due date after this time. Supports date: YYYY-MM-DD, relative: -2d, or ms timestamp. |
--due-end <string> |
No | Query tasks with a due date before this time. Supports date: YYYY-MM-DD, relative: -2d, or ms timestamp. |
--page-all |
No | Automatically paginate through all pages (max 40). |
--page-limit <int> |
No | Max page limit (default 20). |
--page-token <string> |
No | Start from the specified page token (useful for resuming a previous query). |
Workflow
- Determine the filters based on the user's request.
- Execute the command. The CLI will automatically loop up to the specified limit (default 20, or 40 with
--page-all) to fetch records. - Show the results (ID, summary, due time, and created date).