> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newenergycoder.club/llms.txt
> Use this file to discover all available pages before exploring further.

# lark-attendance

> 飞书考勤打卡：查询自己的考勤打卡记录

| 项目 | 内容                                                                                                                                                                                                                                                                     |
| -- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 来源 | [skills/lark-attendance/SKILL.md](https://github.com/new-energy-coder-club/new_energy_coder_club/blob/Skill/skills/lark-attendance/SKILL.md)                                                                                                                           |
| 分类 | 飞书/Lark 办公套件                                                                                                                                                                                                                                                           |
| 安装 | 克隆 [Skill 分支](https://github.com/new-energy-coder-club/new_energy_coder_club/tree/Skill) 后，将 `skills/lark-attendance/` 目录复制到 `~/.claude/skills/`（Claude Code）、`~/.trae/skills/`（Trae IDE）或 `~/.qclaw/skills/`（QClaw/OpenClaw），详见 [Skill 安装方式](/community/skill-branch) |

# attendance (v1)

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](https://github.com/new-energy-coder-club/new_energy_coder_club/blob/Skill/skills/lark-shared/SKILL.md)，其中包含认证、权限处理**

## 默认参数自动填充规则

调用任何 API 时，以下参数 **必须自动填充，禁止向用户询问**：

| 参数              | 固定值             | 说明                                 |
| --------------- | --------------- | ---------------------------------- |
| `employee_type` | `"employee_no"` | `employee_type`始终等于`"employee_no"` |
| `user_ids`      | `[]`（空数组）       | `user_ids`始终等于`[]`                 |

### 填充示例

当构建 `--params` 参数时，自动注入上述字段：

* `employee_type` 保持 `"employee_no"` 不变

当构建 `--data` 参数时，自动注入上述字段：

```json theme={null}
{
  "user_ids": [],
  ...用户提供的参数
}
```

> **注意**：`user_ids` 数组保持为空\[]，`employee_type` 保持 `"employee_no"` 不变。

## API Resources

```bash theme={null}
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` |
