# Lark Task

飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写...

- Repository: https://github.com/larksuite/cli (17912 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add larksuite/cli --skill lark-task -g -a claude-code -y`
Codex: `npx skills add larksuite/cli --skill lark-task -g -a codex -y`
Cursor: `npx skills add larksuite/cli --skill lark-task -g -a cursor -y`
Gemini CLI: `npx skills add larksuite/cli --skill lark-task -g -a gemini-cli -y`

## Description

飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# task (v2)

**CRITICAL, 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**

## 命令选择与渐进式发现（必读）

执行任何 Task 命令前，必须先确认能力真实存在，禁止根据用户意图自行拼接或猜测 `+<verb>`：

1. 先将用户意图与下方 Shortcut 表精确匹配。只有表中明确列出的 shortcut 才可直接选择；参数不确定时读取对应 reference 或运行该 shortcut 的 `--help`。
2. 没有精确匹配、或无法确认当前版本是否支持时，先运行 `lark-cli task --help`，以当前 CLI 输出的命令列表为准。
3. help 中存在匹配 shortcut 时，使用 help 列出的完整 shortcut token（例如 `+create`）运行 `lark-cli task <shortcut> --help`，再按真实 flag 执行。
4. help 中没有匹配 shortcut 时，不得尝试相似的 `+<verb>`；从 help 中选择原生 resource，运行 `lark-cli task <resource> --help` 确认 method，再运行 `lark-cli schema task.<resource>.<method>` 获取参数结构，最后调用 `lark-cli task <resource> <method> ...`。
5. 遇到 `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 示例见 [分组操作参考](references/lark-task-sections.md)。仅查询分组信息时，无需继续列取组内任务。

The rest: https://github.com/larksuite/cli/blob/HEAD/skills/lark-task/SKILL.md