mirror of
https://github.com/larksuite/cli.git
synced 2026-07-03 14:02:43 +08:00
feat: add attendance user_task.query (#405)
Change-Id: Ie34b9b98859942ff368a9808fc2efab4d2bf27fa
This commit is contained in:
57
skills/lark-attendance/SKILL.md
Normal file
57
skills/lark-attendance/SKILL.md
Normal file
@@ -0,0 +1,57 @@
|
||||
---
|
||||
name: lark-attendance
|
||||
version: 1.0.0
|
||||
description: "飞书考勤打卡:查询自己的考勤打卡记录"
|
||||
metadata:
|
||||
requires:
|
||||
bins: ["lark-cli"]
|
||||
cliHelp: "lark-cli attendance --help"
|
||||
---
|
||||
|
||||
# attendance (v1)
|
||||
|
||||
**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md),其中包含认证、权限处理**
|
||||
|
||||
## 默认参数自动填充规则
|
||||
|
||||
调用任何 API 时,以下参数 **必须自动填充,禁止向用户询问**:
|
||||
|
||||
| 参数 | 固定值 | 说明 |
|
||||
|------|--------|------------------------------------|
|
||||
| `employee_type` | `"employee_no"` | `employee_type`始终等于`"employee_no"` |
|
||||
| `user_ids` | `[]`(空数组) | `user_ids`始终等于`[]` |
|
||||
|
||||
### 填充示例
|
||||
|
||||
当构建 `--params` 参数时,自动注入上述字段:
|
||||
- `employee_type` 保持 `"employee_no"` 不变
|
||||
|
||||
当构建 `--data` 参数时,自动注入上述字段:
|
||||
```json
|
||||
{
|
||||
"user_ids": [],
|
||||
...用户提供的参数
|
||||
}
|
||||
```
|
||||
|
||||
> **注意**:`user_ids` 数组保持为空[],`employee_type` 保持 `"employee_no"` 不变。
|
||||
|
||||
## API Resources
|
||||
|
||||
```bash
|
||||
lark-cli schema attendance.<resource>.<method> # 调用 API 前必须先查看参数结构
|
||||
lark-cli attendance <resource> <method> [flags] # 调用 API
|
||||
```
|
||||
|
||||
> **重要**:使用原生 API 时,必须先运行 `schema` 查看 `--data` / `--params` 参数结构,不要猜测字段格式。
|
||||
|
||||
### user_tasks
|
||||
|
||||
- `query` — 查询用户考勤打卡记录
|
||||
|
||||
## 权限表
|
||||
|
||||
| 方法 | 所需 scope |
|
||||
|------|-----------|
|
||||
| `user_tasks.query` | `attendance:task:readonly` |
|
||||
|
||||
Reference in New Issue
Block a user