dingtalk-attendance

Query DingTalk attendance records, shifts summaries and rules via dws attendance commands.

2.7k|181|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-attendance-dingtalk-real-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dingtalk-attendance
Source: https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/tree/main/skills/multi/dingtalk-attendance
Command: npx skills add https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-attendance-dingtalk-real-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openpyxl, and includes scripts (resource) and references (resource) components.

What problem does it solve?

钉钉考勤信息需要安全的查询入口,此 Skill 提供对考勤记录、排班班次、汇总报表等只读操作的直接访问。

Core Features & Use Cases

  • 只读查询:考勤记录、班次、汇总、规则等信息的读取,不支持写操作。
  • 面向代理场景:Agent 在对话中通过命令前缀 dws attendance 发起查询,获取结构化 JSON 结果以供进一步处理。
  • 使用场景示例:当用户咨询某人某日的打卡记录或某个考勤组的排班汇总时,直接调用相应的 dws attendance 子命令。

Quick Start

Fetch a user's attendance data for a given date, using the dws attendance command (for example, dws attendance record get --user <USER_ID> --date <YYYY-MM-DD>).

Frequently Asked Questions about dingtalk-attendance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query DingTalk attendance records for a specific employee and date?

To query DingTalk attendance records, use the command `dws attendance record get --user <USER_ID> --date <YYYY-MM-DD>` to retrieve structured JSON attendance data for that specific user and date.

Can I use this tool to modify or write attendance data in DingTalk?

No, you cannot modify or write attendance data because this tool enforces strict read-only access. It safely queries DingTalk attendance records, shifts, summaries, and rules without performing any write operations.

What DingTalk attendance information can I retrieve through the dws attendance commands?

You can retrieve DingTalk attendance records, shift schedules, summary reports, and attendance rules across multiple users. The dws attendance commands return structured JSON results for further processing.

Do I need any specific environment setup to query DingTalk workplace attendance data?

You need the dws CLI tools available on your PATH and integration with the multi-skill workflow to load appropriate context and safety rules before querying DingTalk workplace attendance data.

How does an agent retrieve DingTalk attendance shift summaries in a conversation?

An agent retrieves DingTalk attendance shift summaries by invoking the appropriate `dws attendance` subcommand during the conversation, which fetches the scheduling data and returns it as structured JSON for analysis.

What are the limitations of querying DingTalk attendance data with this approach?

The primary limitation is that all DingTalk attendance queries are strictly read-only, meaning you cannot update records, modify schedules, or write data. It only supports fetching existing attendance information.