diff --git a/internal/registry/service_descriptions.json b/internal/registry/service_descriptions.json index fe2907981..799aca1eb 100644 --- a/internal/registry/service_descriptions.json +++ b/internal/registry/service_descriptions.json @@ -1,4 +1,8 @@ { + "approval": { + "en": { "title": "Approval API", "description": "Approval instance, and task management" }, + "zh": { "title": "审批 API", "description": "审批实例、审批任务管理" } + }, "base": { "en": { "title": "Base", "description": "Table, field, record, view, dashboard, workflow, form, role & permission management" }, "zh": { "title": "多维表格", "description": "数据表、字段、记录、视图、仪表盘、自动化流程、表单、角色权限管理" } diff --git a/skills/lark-approval/SKILL.md b/skills/lark-approval/SKILL.md new file mode 100644 index 000000000..14747dd21 --- /dev/null +++ b/skills/lark-approval/SKILL.md @@ -0,0 +1,48 @@ +--- +name: lark-approval +version: 1.0.0 +description: "飞书审批 API:审批实例、审批任务管理。" +metadata: + requires: + bins: ["lark-cli"] + cliHelp: "lark-cli approval --help" +--- + +# approval (v4) + +**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md),其中包含认证、权限处理** + +## API Resources + +```bash +lark-cli schema approval.. # 调用 API 前必须先查看参数结构 +lark-cli approval [flags] # 调用 API +``` + +> **重要**:使用原生 API 时,必须先运行 `schema` 查看 `--data` / `--params` 参数结构,不要猜测字段格式。 + +### instances + + - `get` — 获取单个审批实例详情 + - `cancel` — 撤回审批实例 + - `cc` — 抄送审批实例 + +### tasks + + - `approve` — 同意审批任务 + - `reject` — 拒绝审批任务 + - `transfer` — 转交审批任务 + - `query` — 查询用户的任务列表 + +## 权限表 + +| 方法 | 所需 scope | +|------|-----------| +| `instances.get` | `approval:instance:read` | +| `instances.cancel` | `approval:instance:write` | +| `instances.cc` | `approval:instance:write` | +| `tasks.approve` | `approval:task:write` | +| `tasks.reject` | `approval:task:write` | +| `tasks.transfer` | `approval:task:write` | +| `tasks.query` | `approval:task:read` | +