lark-approval

Name: lark-approval
Author: larksuite

bylarksuite· 47 skills

Installs

360k

Stars

16k

Forks

1.2k

How to install lark-approval?

larksuite/cli/lark-approval

$npx -y skills add larksuite/cli --skill lark-approval

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Use this skill

Run `npx skills use "https://github.com/larksuite/cli" --skill "larksuite/cli/lark-approval"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.

Use the whole pack

Use the skills in "https://github.com/larksuite/cli" that are relevant to the current task. Run `npx skills add "https://github.com/larksuite/cli"` and select the relevant skills, then follow their instructions.

Files · 1

View on GitHub

SKILL.md

1	CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理
2
3	所有命令默认 `--as user`（审批是人的动作）。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；references 是第一信息源，只有在 reference 未覆盖的原生 / 高级场景下，才额外用 `lark-cli ... --help`、`lark-cli schema` 等方式补充确认字段。
4
5	## 路由优先级（先判断是不是审批，再选命令）
6
7	审批待办不是飞书任务。只要用户的核心对象是审批单据 / 审批待办 / 审批实例，就优先使用 `lark-approval`，不要让渡给 `lark-task`。
8
9	### 明确归 `lark-approval` 的高优先级语义
10
11	出现以下任一语义时，优先走 `lark-approval`：
12
13	- 审批待办 / 审批单据 / 审批实例 / 审批意见 / 审批定义
14	- 同意 / 拒绝 / 转交 / 退回 / 撤回 / 催办 / 加签 / 抄送
15	- 待办列表 / 待办单据 / 已发起审批 / 已办审批 / 审批详情 / 同意可编辑
16
17	判定规则：只要最终动作是对审批单据做同意、拒绝、转交、退回、撤回、催办、加签、抄送、查详情、查已发起/已办/待办，就归 `lark-approval`。只有当用户处理的是非审批类任务/待办时，才走 [`lark-task`](../lark-task/SKILL.md)。
18
19	## 选哪个命令
20
21	\| 想做什么 \| 命令 \| 按需读取 reference \|
22	\|---\|---\|---------------------------------------------------------------------------------\|
23	\| 搜可发起定义 \| `approvals search` \| [`lark-approval-approvals-search.md`](references/lark-approval-approvals-search.md) \|
24	\| 看审批定义详情/提单前确认表单与流程 \| `approvals get` \| [`lark-approval-approvals-get.md`](references/lark-approval-approvals-get.md) \|
25	\| 发起原生审批实例/提交请假审批/提交报销审批/创建审批实例 \| `instances create` \| [`lark-approval-initiate.md`](references/lark-approval-initiate.md) \|
26	\| 查待办/已办 \| `tasks query`（`topic`：1待办 2已办 17未读 18已读） \| [`lark-approval-tasks-query.md`](references/lark-approval-tasks-query.md) \|
27	\| 看表单/进度/当前节点 \| `instances get` \| [`lark-approval-instances-get.md`](references/lark-approval-instances-get.md) \|
28	\| 同意审批 \| `tasks approve` \| [`lark-approval-tasks-approve.md`](references/lark-approval-tasks-approve.md) \|
29	\| 拒绝审批 \| `tasks reject` \| [`lark-approval-tasks-reject.md`](references/lark-approval-tasks-reject.md) \|
30	\| 转交审批 \| `tasks transfer` \| [`lark-approval-tasks-transfer.md`](references/lark-approval-tasks-transfer.md) \|
31	\| 加签审批 \| `tasks add_sign` \| [`lark-approval-tasks-add-sign.md`](references/lark-approval-tasks-add-sign.md) \|
32	\| 退回审批 \| `tasks rollback` \| [`lark-approval-tasks-rollback.md`](references/lark-approval-tasks-rollback.md) \|
33	\| 催办审批 \| `tasks remind` \| [`lark-approval-tasks-remind.md`](references/lark-approval-tasks-remind.md) \|
34	\| 撤回已发起审批 \| `instances cancel` \| [`lark-approval-instances-cancel.md`](references/lark-approval-instances-cancel.md) \|
35	\| 给审批实例追加抄送 \| `instances cc` \| [`lark-approval-instances-cc.md`](references/lark-approval-instances-cc.md) \|
36	\| 按定义查已发起审批 \| `instances initiated` \| [`lark-approval-instances-initiated.md`](references/lark-approval-instances-initiated.md) \|
37
38	处理链：
39
40	- 发起审批：`approvals search` -> `approvals get` -> `instances create`
41	- 处理审批：`tasks query` 拿 `instance_code` + `task_id`（操作必须成对带上）→ 只有用户明确需要查看详情、当前节点、表单内容、或流程进度时，再 `instances get` → 执行操作
42
43	## 执行原则（减少误路由、误重试和无效消耗）
44
45	### 1) 先拿最小必要信息，再执行
46
47	- 目标只是处理待办时，优先 `tasks query` 获取 `instance_code` + `task_id`
48	- 只有用户明确要看详情、当前节点、表单内容、流程进度时，才调用 `instances get`
49	- 用户已经明确给出 `instance_code` / `task_id` 时，不要先查列表再过滤
50
51	### 2) 已知对象时直达动作
52
53	- 已拿到 `instance_code` + `task_id` 后，优先直接执行 `tasks approve/reject/transfer/add_sign/rollback/remind`
54	- 同一轮里如果已有足够的新鲜查询结果，不要重复 `tasks query`
55	- 不要默认走 `list -> filter -> detail -> write` 全链路；对象已明确时应压缩步骤
56
57	### 3) 错误码驱动，而不是盲目重试
58
59	- 写操作失败后，先看错误码和报错语义，再决定是否补查或结束
60	- 除非错误明确提示可恢复或需要补充参数，否则不要重复刷同一个写操作
61	- 同一个失败原因不要连续多次重试，避免 token 和耗时失控，最多重试1次
62
63	## 写操作失败处理：1395001 决策树
64
65	当拒绝 / 转交 / 退回 / 撤回 / 同意等写操作返回 `1395001`（任务状态异常 / 写前置校验失败）时，按下面规则处理：
66
67	1. 先停止盲目重试，不要连续重复提交相同写操作，最多重试1次
68	2. 优先从以下角度解释：
69	- 任务可能已被他人处理
70	- 单据状态已变化，当前动作已不再允许
71	- 当前用户已不具备该任务的操作资格
72	- 当前节点或单据状态不支持该操作
73	3. 如需确认，只补一次状态查询（`tasks query` 或 `instances get`），不要陷入 query/write 循环
74	4. 最终给用户明确结论和下一步建议，而不是继续无意义重试
75
76	特别注意：对拒绝 / 转交 / 撤回场景更要严格执行上述规则；这些场景最容易因状态切换而失败。
77
78	```bash
79	lark-cli approval approvals search --data '{"keyword":"请假"}' --as user
80	lark-cli approval approvals get --params '{"approval_code":"<code>"}' --as user
81	lark-cli approval instances create --data '{"approval_code":"<code>","form":"[...]"}' --yes --as user
82	lark-cli approval tasks query --params '{"topic":"1"}' --as user
83	lark-cli approval tasks approve --data '{"instance_code":"<ic>","task_id":"<tid>","comment":"同意"}' --as user
84	```
85
86	## 不在本 skill 范围
87
88	创建审批定义（走飞书客户端或审批管理后台）；三方定义发起（返回 `create_link`，引导用户通过链接发起）；非审批类待办 → [`lark-task`](../lark-task/SKILL.md)

6 picks

Type

Run `npx skills use "https://github.com/larksuite/cli" --skill "larksuite/cli/lark-approval"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.

Use the skills in "https://github.com/larksuite/cli" that are relevant to the current task. Run `npx skills add "https://github.com/larksuite/cli"` and select the relevant skills, then follow their instructions.

lark-approval

How to install lark-approval?

Related

lark-approval

How to install lark-approval?

Related