| name | lark-approval |
| version | 1.2.0 |
| description | 飞书审批：查询和处理审批待办/已办/实例，搜索可发起审批定义、查看定义详情并发起原生审批实例。当用户要处理审批任务、查看审批实例、搜索或发起审批时使用。审批待办不是飞书任务；非审批类待办走 lark-task。不负责创建审批定义；三方审批定义不走原生提单。 |
| metadata | {"requires":{"bins":["lark-cli"]},"cliHelp":"lark-cli approval --help"} |
⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）
本技能依赖本地 lark-cli（@larksuite/cli，可用 command -v lark-cli 定位）及其 ~/.lark-cli 登录态（应用密钥存于 macOS keychain）。
在 Cowork 中运行任何 lark-cli 命令时，必须在本地 macOS 上执行（使用 Desktop Commander 的 start_process / interact_with_process，或其它本地 shell 工具），不要用隔离的 Linux 沙箱 mcp__workspace__bash——沙箱里没有 lark-cli、也读不到 keychain。
执行前确保 npm 全局 bin 目录（npm prefix -g 输出目录下的 bin）在 PATH 中。
（在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）
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
发起原生审批
发起审批属于高风险写操作，按下表处理：
不在本 skill 范围
创建审批定义（走飞书客户端或审批管理后台）；三方定义发起（返回 create_link，引导用户通过链接发起）；非审批类待办 → lark-task
