- name
- lark-task
- version
- 1.0.1
- description
- 【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册任务智能体、更新任务智能体主页数据、写入任务记录时使用。
- metadata
- requires: bins: ["lark-cli"] cliHelp: "lark-cli task --help"
task (v2)
CRITICAL — 开始前 MUST 先用 read 读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
命令选择与渐进式发现（必读）
执行任何 Task 命令前，必须先确认能力真实存在，禁止根据用户意图自行拼接或猜测 +<verb>：
- 先将用户意图与下方 Shortcut 表精确匹配。只有表中明确列出的 shortcut 才可直接选择；参数不确定时读取对应 reference 或运行该 shortcut 的
--help。 - 没有精确匹配、或无法确认当前版本是否支持时，先运行
lark-cli task --help，以当前 CLI 输出的命令列表为准。 - help 中存在匹配 shortcut 时，使用 help 列出的完整 shortcut token（例如
+create）运行lark-cli task <shortcut> --help，再按真实 flag 执行。 - help 中没有匹配 shortcut 时，不得尝试相似的
+<verb>；从 help 中选择原生 resource，运行lark-cli task <resource> --help确认 method，再运行lark-cli schema task.<resource>.<method>获取参数结构，最后调用lark-cli task <resource> <method> ...。 - 遇到
unknown_subcommand时必须停止猜测或尝试变体，回到第 2 步重新发现能力。
shortcut 名称只能来自本 Skill 的 Shortcut 表或 lark-cli task --help；原生 resource/method 以逐级 help 为准，参数名、类型和嵌套结构以 method schema 为准。
任务分组定位（必读）：
- 在飞书任务/任务中心语境中，用户说“分组 / groups”时，优先对应
sections；任务清单对应tasklists。先确定分组归属，再选择查询路径。- 明确属于“我的任务”时，用
sections.list的my_tasks归属和--as user查询，无需填写--resource-id；明确属于某个清单时，用tasklist归属，并将该清单 GUID 传给--resource-id。- 归属不明时，先结合上下文判断，仍不明确再询问属于“我的任务”还是哪个清单；不要为了定位分组先遍历所有任务清单。
- 已知
section_guid时，直接用sections.tasks查询组内任务；仅有分组名称时，先列取所属资源的分组并取得guid。同名候选展示 GUID 和已知归属，不自动选择第一条。- 分组操作的流程和 schema-first 示例见 分组操作参考。仅查询分组信息时，无需继续列取组内任务。
任务搜索技巧：先区分用户是否特地指定使用搜索 skill，以及是否真的提供了查询关键字（例如任务名称、关键词、片段描述）。如果用户特地指定使用搜索 skill，或明确给出了任务查询关键字，则目标是任务时优先使用
+search。如果用户没有特地指定使用搜索 skill，且意图里没有查询关键字，只有范围条件（例如“今年以来”“已完成”“由我创建”“我关注的”），并且使用+search与+get-related-tasks/+get-my-tasks都能达到目的时，应优先使用列表型能力，而不是搜索型能力。其中，“与我相关 / 我关注的 / 由我创建”等优先考虑 ；“我负责的 / 分配给我”的列表优先考虑 。不要把时间范围词（例如“今年以来”）本身误当成 去走搜索。 ： 当前不会自动判断搜索结果与搜索发起人的相关性。如果用户明确要求搜索“与我相关”的任务，必须先识别具体关系，获取当前用户的 ，并显式传入对应的 （负责人）、（创建人）或 （关注人）过滤条件；不能只依赖 期待自动返回与当前用户相关的任务。 ：任务清单也遵循同样的判断逻辑。先区分用户是否，以及是否真的提供了（例如清单名称、关键词、片段描述）。如果用户特地指定使用搜索 skill，或明确给出了清单查询关键字，则优先使用 。如果用户没有特地指定使用搜索 skill，且意图里没有查询关键字，只有范围条件（例如“由我创建的任务清单”“今年以来创建的清单”），并且使用搜索或原生列取清单都能达到目的时，应优先使用原生 接口列取清单（先 ，再 ），再按 、 等字段做本地筛选和分页控制。 ：像“搜索飞书中今年以来我关注的任务”这类表达，虽然字面带有“搜索”，但如果没有真正的查询关键字，且本质是在限定“与我相关 + 时间范围”，则应优先走 ；像“搜索飞书中由我创建的任务清单”这类表达，如果没有清单关键字，且本质是在限定“清单范围 + 创建者”，则应优先走原生 后筛选，而不是直接走搜索型 shortcut。 ：在用户身份（user identity）场景下，如果用户提到了“我”（例如“分配给我”、“由我创建”），请默认获取当前登录用户的 作为对应的参数值（用 获取，从输出 JSON 的 提取，见 速查表）。 ：