Skill

lark-approval

open.feishu.cn

Query, process, and initiate Lark approval tasks via CLI — search definitions, manage instances, and handle approvals.

What is lark-approval?

lark-approval is a skill for coding agents that enables interaction with Lark (Feishu) approval workflows via lark-cli. It covers querying pending/completed approval tasks, viewing approval instances and their form data, searching approval definitions, and initiating native approval instances. It does not create approval definitions or handle third-party approval submissions.

Search available approval definitions by keyword
Retrieve approval definition details including form structure and workflow
Create (initiate) native approval instances with form data
Query pending and completed approval tasks (todo, done, unread, read)
Approve, reject, transfer, add signers, or roll back approval tasks
Cancel instances, send reminders, CC approvals, and list user-initiated instances

How to install lark-approval

npx skills add null --skill lark-approval

Prerequisites

lark-cli must be installed and available in PATH
lark-shared SKILL.md must be read first for authentication and permission setup
Appropriate Lark user credentials configured for --as user mode
Access to the target Lark tenant's approval definitions

Claude Code

Cursor

Windsurf

Cline

How to use lark-approval

1.Read ../lark-shared/SKILL.md before any commands to handle auth and permissions
2.Run lark-cli schema approval.<resource>.<method> to inspect parameter structures before calling any command
3.To initiate an approval: run approvals search, then approvals get, then instances create
4.To process a task: run tasks query to get instance_code and task_id, optionally run instances get for details, then run approve/reject/transfer etc.
5.For third-party definitions (is_external=true), do not call instances create — return the create_link to the user instead
6.Before executing instances create, confirm form values and node parameters with the user, then pass --yes flag
7.After successful creation, report back the instance_code and instance_link
8.For non-approval todos, use the lark-task skill instead

Use cases

Good for

Submit a leave request or expense reimbursement approval
Check and act on pending approval tasks in your queue
Look up the current status, form values, and progress of an approval instance
Transfer or escalate an approval task to another person
Remind approvers about a pending approval

Who it's for

Developers building Lark workflow automation
Agents or bots that need to process approval tasks on behalf of users
Teams automating HR or finance approval submissions
Engineers integrating Lark approval status into other tools

lark-approval FAQ

Can this skill create approval definitions?

No. Creating approval definitions must be done via the Lark client or approval admin console. This skill only initiates instances against existing definitions.

What is the difference between approval tasks and regular tasks?

Approval todos are approval workflow actions (approve, reject, etc.). Non-approval todos should be handled by the lark-task skill.

How do I handle third-party approval definitions?

If approvals get returns is_external=true, do not call instances create. Instead, return the create_link and instruct the user to initiate via that link.

How do I find the right topic value for tasks query?

Use topic 1 for pending (todo), 2 for completed (done), 17 for unread, and 18 for read.

Why must I call approvals search and approvals get before instances create?

The form field structure, control value formats, and node approver parameters depend on the specific definition. Guessing these fields without reading the definition will produce errors.

Full instructions (SKILL.md)

Source of truth, from open.feishu.cn.

name: lark-approval version: 1.2.0 description: "飞书审批：查询和处理审批待办/已办/实例，搜索可发起审批定义、查看定义详情并发起原生审批实例。当用户要处理审批任务、查看审批实例、搜索或发起审批时使用。审批待办不是飞书任务；非审批类待办走 lark-task。不负责创建审批定义；三方审批定义不走原生提单。" metadata: requires: bins: ["lark-cli"] cliHelp: "lark-cli approval --help"

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理

所有命令默认 --as user（审批是人的动作）。调用前先 lark-cli schema approval.<resource>.<method> 查参数结构，不要猜字段。

选哪个命令

想做什么	命令
搜可发起定义	`approvals search`
看审批定义详情/提单前确认表单与流程	`approvals get`
发起原生审批实例	`instances create`
查待办/已办	`tasks query`（`topic`：1待办 2已办 17未读 18已读）
看表单/进度/当前节点	`instances get`
同意/拒绝	`tasks approve` / `tasks reject`
转交/加签/退回	`tasks transfer` / `tasks add_sign` / `tasks rollback`
催办	`tasks remind`
撤回/抄送/按定义查已发起	`instances cancel` / `instances cc` / `instances initiated`

处理链：

发起审批：approvals search -> approvals get -> instances.create
处理审批：tasks query 拿 instance_code + task_id（操作必须成对带上）→ 需要细节再 instances get → 执行操作

lark-cli approval approvals search --data '{"keyword":"请假"}' --as user
lark-cli approval approvals get --params '{"approval_code":"<code>"}' --as user
lark-cli approval instances create --data '{"approval_code":"<code>","form":"[...]"}' --yes --as user
lark-cli approval tasks query --params '{"topic":"1"}' --as user
lark-cli approval tasks approve --data '{"instance_code":"<ic>","task_id":"<tid>","comment":"同意"}' --as user

发起原生审批

发起审批属于高风险写操作，按下表处理：

规则	处理
用户意图是发起审批 / 提单 / 提交请假审批 / 提交报销审批 / 创建审批实例	先读 `references/lark-approval-initiate.md`、`references/lark-approval-instance-form-control-parameters.md` 和 `references/lark-approval-instance-value-sourcing.md`，并运行 `lark-cli schema approval.instances.create`
编排顺序	固定走 `approvals.search` -> `approvals.get` -> `instances.create`；未拿到定义详情前不要猜 `form`、`node_approver_list` 或 `node_cc_list`
三方定义	`is_external=true` 时不要调用 `approval instances create`，返回 `create_link` 并说明需通过链接发起
表单与节点参数	控件 `value` 结构看 `references/lark-approval-instance-form-control-parameters.md`；值来源看 `references/lark-approval-instance-value-sourcing.md`
真正执行前	让用户确认最终定义、表单值和节点参数；执行时显式传 `--yes`，成功后回报 `instance_code` 与 `instance_link`