--- 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` |