PicoBot/skills/lark-task/references/lark-task-tasklist-search.md
ooodc a7883dbed9 refactor(todo): 重构待办事项管理逻辑及更新状态规则
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段
- 强制每个任务都必须有唯一 id,且由用户负责生成
- 修改合并模式逻辑,merge=true 下保留未提及的旧任务
- 支持已完成和已取消任务重新激活(状态改回 pending 或 in_progress)
- 禁止 in_progress 状态退回到 pending,必须标记为 completed 或 cancelled
- 优化状态转换校验,允许特定状态间合法切换
- 简化任务变更消息,移除详细的新增/更新/移除统计
- 更新文档和示例,明确 id 必须由用户生成和使用
- 修复和补充测试,增强状态转换和合并模式验证
- 调整任务时间戳生成逻辑,统一使用当前时间及索引
- 该变更提供更合理的任务状态机械及管理模式,提升稳定性和易用性
2026-06-13 09:22:33 +08:00

1.4 KiB

task +tasklist-search

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

⚠️ Note: This shortcut uses tasklist search followed by tasklist detail queries to render the final output.

Search tasklists by keyword and optional filters.

# Search by keyword
lark-cli task +tasklist-search --query "测试"

# Search tasklists created by specific users
lark-cli task +tasklist-search --creator "ou_xxx,ou_yyy"

# Search by creation time range
lark-cli task +tasklist-search --query "Q2" --create-time "-30d,+0d"

Parameters

Parameter Required Description
--query <string> No Search keyword. If omitted, at least one filter must be provided.
--creator <ids> No Creator open_ids, comma-separated.
--create-time <range> No Creation time range in start,end form. Each side supports ISO/date/relative/ms input.
--page-token <string> No Page token for pagination.
--page-all No Automatically paginate through all pages (max 40).
--page-limit <int> No Max page limit (default 20).

Workflow

  1. Build the search keyword and filters from the user's request.
  2. Execute lark-cli task +tasklist-search ...
  3. Report the matched tasklists and the next page_token if more results exist.