用途
lark-attendance 是一个飞书考勤打卡相关技能,主要用于查询自己的考勤打卡记录。它属于 shunsukehayashi/lark-harness 项目,通过飞书开放平台提供的考勤 API 完成数据查询。
主要能力
该技能目前包含一个 API 资源与方法:
- user_tasks.query:查询用户考勤打卡记录。
使用方式
前置步骤
开始前必须先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证、权限处理方法。
默认参数自动填充规则
调用任何 API 时,以下参数必须自动填充,禁止向用户询问:
| 参数 | 固定值 | 说明 |
|---|---|---|
| employee_type | "employee_no" | employee_type 始终等于 "employee_no" |
| user_ids | [](空数组) | user_ids 始终等于 [] |
填充示例:
- 构建
--params参数时,自动注入上述字段。 - employee_type 保持 "employee_no" 不变。
- 构建
--data参数时,自动注入上述字段:
{
"user_ids": [],
...用户提供的参数
}
注意:user_ids 数组保持为空 [],employee_type 保持 "employee_no" 不变。
API 调用命令
查看参数结构:
lark-cli schema attendance.<resource>.<method>
调用 API:
lark-cli attendance <resource> <method> [flags]
重要:使用原生 API 时,必须先运行 schema 查看 --data / --params 参数结构,不要猜测字段格式。
权限
| 方法 | 所需 scope |
|---|---|
| user_tasks.query | attendance:task:readonly |
适用场景
适用于用户需要在飞书环境中查询自己的考勤打卡记录的场景,例如核对每日打卡情况。
限制
- 当前技能仅提供 user_tasks.query 一个方法,功能范围有限。
- 使用前依赖 lark-shared 模块进行认证与权限处理。
- 部分参数(如具体查询时间范围等)在资料中暂未提供详细说明,需通过 schema 命令查看实际参数结构。