diff --git a/skills/lark-approval/SKILL.md b/skills/lark-approval/SKILL.md index c5b0fe787..69ac22f90 100644 --- a/skills/lark-approval/SKILL.md +++ b/skills/lark-approval/SKILL.md @@ -1,7 +1,7 @@ --- name: lark-approval version: 1.0.0 -description: "飞书审批 API:审批实例、审批任务管理。" +description: "飞书审批:查询待办任务、查询审批实例、处理审批任务(同意/拒绝/转交/加签/退回/催办)。当用户需要查询待办任务、查看审批详情、处理待审批任务、催办审批人、撤回已发起的审批时使用。不负责:创建审批定义/表单设计(走原生 OpenAPI)、发起新审批(需通过飞书客户端或走原生 OpenAPI发起)。" metadata: requires: bins: ["lark-cli"] @@ -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.. # 调用 API 前必须先查看参数结构 -lark-cli approval [flags] # 调用 API -``` +## API Resources -> **重要**:使用原生 API 时,必须先运行 `schema` 查看 `--data` / `--params` 参数结构,不要猜测字段格式。 ### instances @@ -38,19 +34,8 @@ lark-cli approval [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) \ No newline at end of file