mcpField
L
lark-attendance

lark-attendance

larksuite生産性17.9k420.3k 回インストール今日更新
リポジトリ

lark-attendance について

lark-attendance は Lark 勤怠 API 向けのスキルで、現在はユーザーの打刻記録の取得に対応しています。呼び出しに使う固定のデフォルト値を補完し、呼び出し前にパラメーター構造を確認する仕組みを備えており、勤怠データを読み取るエージェントに向いています。

主な機能

  1. 01ユーザーの勤怠打刻記録の取得(user_tasks.query)
  2. 02呼び出し前の schema によるパラメーター構造の確認
  3. 03employee_type と user_ids のデフォルト値の自動補完
  4. 04必要な attendance:task:readonly スコープの明記

活用シーン

  1. 01エージェントが特定の従業員の打刻記録を取得する
  2. 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.queryattendance:task:readonly

コメント