lark-attendance

name	lark-attendance
version	1.0.0
description	飞书考勤打卡：查询自己的考勤打卡记录
metadata	{"requires":{"bins":["lark-cli"]},"cliHelp":"lark-cli attendance --help"}

⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）

本技能依赖本地 lark-cli（@larksuite/cli，可用 command -v lark-cli 定位）及其 ~/.lark-cli 登录态（应用密钥存于 macOS keychain）。

在 Cowork 中运行任何 lark-cli 命令时，必须在本地 macOS 上执行（使用 Desktop Commander 的 start_process / interact_with_process，或其它本地 shell 工具），不要用隔离的 Linux 沙箱 mcp__workspace__bash——沙箱里没有 lark-cli、也读不到 keychain。 执行前确保 npm 全局 bin 目录（npm prefix -g 输出目录下的 bin）在 PATH 中。

（在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）

attendance (v1)

CRITICAL — 开始前 MUST 先用 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 Resources

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