Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 7 additions & 22 deletions skills/lark-approval/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: lark-approval
version: 1.0.0
description: "飞书审批 API:审批实例、审批任务管理。"
description: "飞书审批:查询待办任务、查询审批实例、处理审批任务(同意/拒绝/转交/加签/退回/催办)。当用户需要查询待办任务、查看审批详情、处理待审批任务、催办审批人、撤回已发起的审批时使用。不负责:创建审批定义/表单设计(走原生 OpenAPI)、发起新审批(需通过飞书客户端或走原生 OpenAPI发起)。"
metadata:
requires:
bins: ["lark-cli"]
Expand All @@ -12,14 +12,10 @@ metadata:

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

## API Resources
**身份**:审批操作默认使用 `--as user`(以当前登录用户身份处理审批任务)

```bash
lark-cli schema approval.<resource>.<method> # 调用 API 前必须先查看参数结构
lark-cli approval <resource> <method> [flags] # 调用 API
```
## API Resources

> **重要**:使用原生 API 时,必须先运行 `schema` 查看 `--data` / `--params` 参数结构,不要猜测字段格式。

### instances

Expand All @@ -38,19 +34,8 @@ lark-cli approval <resource> <method> [flags] # 调用 API
- `add_sign` — 审批任务加签
- `rollback` — 退回审批任务

## 权限表

| 方法 | 所需 scope |
|------|-----------|
| `instances.get` | `approval:instance:read` |
| `instances.cancel` | `approval:instance:write` |
| `instances.cc` | `approval:instance:write` |
| `instances.initiated` | `approval:instance:read` |
| `tasks.remind` | `approval:instance:write` |
| `tasks.approve` | `approval:task:write` |
| `tasks.reject` | `approval:task:write` |
| `tasks.transfer` | `approval:task:write` |
| `tasks.query` | `approval:task:read` |
| `tasks.add_sign` | `approval:task:write` |
| `tasks.rollback` | `approval:task:write` |
## 不在本 skill 范围

- 创建审批定义/表单设计 → 原生 OpenAPI(通过 lark-openapi-explorer 查找)
- 发起新审批实例 → 原生 OpenAPI
- 待办任务(非审批类)→ [`lark-task`](../lark-task/SKILL.md)
Loading