SuperAPI AI 工具集

lark-attendance

办公与效率

查看项目

更新于 10-16 09:41

技能介绍

用途

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 命令查看实际参数结构。