lark-attendance について
lark-attendance は Lark 勤怠 API 向けのスキルで、現在はユーザーの打刻記録の取得に対応しています。呼び出しに使う固定のデフォルト値を補完し、呼び出し前にパラメーター構造を確認する仕組みを備えており、勤怠データを読み取るエージェントに向いています。
主な機能
- 01ユーザーの勤怠打刻記録の取得(user_tasks.query)
- 02呼び出し前の schema によるパラメーター構造の確認
- 03employee_type と user_ids のデフォルト値の自動補完
- 04必要な attendance:task:readonly スコープの明記
活用シーン
- 01エージェントが特定の従業員の打刻記録を取得する
- 02レポートや異常確認のために勤怠データを照合する
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ larksuite/ cli --skill lark-attendanceインストール後、Claude Code で/lark-attendanceを入力して読み込まれたか確認します。
README(原文)English
プロジェクトの README よりこの README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。
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 |
コメント
Markdown 対応