lark-approval

SkillCommunityTranslated from Chinese

This skill enables AI agents to manage Lark approvals, including querying pending or completed tasks and performing actions like approving, rejecting, or transferring requests. It requires the lark-shared skill for authentication and is intended for existing approval workflows rather than creating new definitions.

Compatibility:

Install:

npx skills add open.feishu.cn/lark-approval

View on skills.sh

CRITICAL, Before starting, you MUST use the Read tool to read ../lark-shared/SKILL.md, which contains authentication and permission handling.

All commands default to --as user (approval is a human action). Before calling, use lark-cli schema approval.<resource>.<method> to check the parameter structure. Do not guess fields.

Which command to choose

Goal	Command
Check pending/completed tasks	`tasks query` (`topic`: 1 pending, 2 completed, 17 unread, 18 read)
View form/progress/current node	`instances get`
Approve/Reject	`tasks approve` / `tasks reject`
Transfer/Add sign/Rollback	`tasks transfer` / `tasks add_sign` / `tasks rollback`
Remind	`tasks remind`
Cancel/CC/Query initiated by definition	`instances cancel` / `instances cc` / `instances initiated`

Processing chain: tasks query to get instance_code + task_id (operations must include both) → instances get if details are needed → execute operation.

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

Out of scope for this skill

Creating approval definitions/initiating new approvals (use the Lark client or approval management backend); non-approval tasks → lark-task

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

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

选哪个命令

想做什么	命令
查待办/已办	`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`

处理链：tasks query 拿 instance_code + task_id（操作必须成对带上）→ 需要细节再 instances get → 执行操作。

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