| name | dingtalk-attendance |
| description | 钉钉考勤。Use when 用户说 考勤/打卡记录/查打卡/查班次/考勤汇总/考勤规则/出勤情况/请假加班补卡/排班/考勤组/假期余额。命令前缀：dws attendance。支持查询与写操作（班次、排班、考勤组、个人规则设置、假期规则/余额等），写操作需二次确认后再加 --yes。 |
| cli_version | >=0.2.14 |
| metadata | {"category":"product","stability":"experimental","requires":{"bins":["dws"]}} |
钉钉考勤 Skill
🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。全部 dingtalk-* skill 已通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（dws skill setup --mode mono）。问题请提 issue 反馈。
PREREQUISITE: Read the dws-shared skill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. The dws binary must be on PATH.
⚠️ 命令可用性以当前 dws 二进制为准。服务发现已下线，本文档随内置 skill 发布；如果 dws <cmd> --help 不存在，说明当前版本未暴露该命令。若命令存在但调用失败，请按错误中的 endpoint 或 tool 提示确认静态端点目录和后端工具注册。实际调用前可用 dws <cmd> --help 或 --dry-run 验证。
命令参考：attendance.md。
Shortcuts（无专用脚本/recipe 时优先）
以下 shortcut 来自独立于 Runtime Schema 的公开 catalog。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。用 dws shortcut list --service attendance --format json 读取参数、约束、风险和示例，并以 dws attendance <shortcut> --help 核对当前 Cobra flags；不要对 + 路径调用 dws schema。
| Shortcut | 风险 | 适用场景 |
|---|
dws attendance +check-record | read | 查询用户打卡流水（打卡时间/地点/定位方式） |
dws attendance +check-result | read | 查询用户打卡结果（迟到/早退/缺卡等） |
dws attendance +get-adjustment-rule | read | 根据补卡规则主键 ID 查询补卡规则详情 |
dws attendance +get-approve-template | read | 查询补卡/请假/加班/外出/出差审批提交链接 |
dws attendance +get-checkin-record | read | 查询指定员工一段时间内的签到记录 |
dws attendance +get-leave-records | read | 查询指定员工的假期余额变更记录 |
dws attendance +get-overtime-rule | read | 根据加班规则主键 ID 查询加班规则详情 |
dws attendance +get-schedule | read | 获取指定用户一段时间内的排班记录 |
dws attendance +get-self-setting | read | 查询个人规则设置（打卡提醒/极速打卡/缺卡提醒等） |
dws attendance +get-summary | read | 查询某个人的考勤统计摘要（周/月） |
dws attendance +list-approve | read | 查询用户考勤审批单（补卡/加班/请假/出差外出） |
dws attendance +list-leave-types | read | 查询当前用户可用的假期规则列表 |
dws attendance +my-attendance | read | 查我今天的考勤打卡记录（打卡流水，自动解析当前用户） |
dws attendance +query-report-data | read | 根据字段查询考勤报表数据（仅管理员） |
dws attendance +search-adjustment-rule | read | 查询当前用户可管理的补卡规则列表 |
dws attendance +search-class | read | 查询当前用户可管理的班次详情列表 |
dws attendance +search-group | read | 查询当前用户可管理的考勤组列表 |
dws attendance +search-overtime-rule | read | 查询当前用户可管理的加班规则列表 |
dws attendance +this-month | read | 查我本月的考勤打卡记录（打卡流水，自动解析当前用户） |
意图表
| 用户说 | 命令 |
|---|
| "查我 / 某人 某天的打卡" | dws attendance record get --user <userId> --date <YYYY-MM-DD> |
| "查考勤组 / 考勤规则 / 打卡范围" | dws attendance rules --date <YYYY-MM-DD> |
| "查班次 / 排班 / 谁今天上什么班" | dws attendance shift list --users <userId1,userId2> --start <YYYY-MM-DD> --end <YYYY-MM-DD> |
| "考勤统计 / 周月汇总 / 出勤天数" | dws attendance summary --user <userId> --date <YYYY-MM-DD> --stats-type week|month |
| "请假 / 加班 / 补卡 / 出差 记录或提交链接" | dws attendance approve list / dws attendance approve templates --type <类型> |
| "班次 / 补卡规则 / 加班规则 / 考勤组 查询与修改" | class / adjustment / overtime / group 子命令 |
| "排班 / 假期规则 / 假期余额 / 签到 / 报表" | schedule / vacation / checkin / report 子命令 |
完整命令集（含写操作与参数）见 references/attendance.md。
评测高频硬约束
- 当前 dws 已注册全部考勤子命令组（
record / check / approve / shift / schedule / class / adjustment / overtime / group / summary / rules / selfsetting / globalsetting / vacation / checkin / report / boss-check），查询与写操作大多可直接调用后端。不要再以"开源版只读/不支持写操作"为由拒答。 创建班次、导入排班、加人入考勤组、保存个人规则设置、设置假期余额等写操作可执行，但必须先展示参数摘要并二次确认，再追加 --yes（或 --user-say-yes）执行；不要在未确认时直接写、也不要伪装成功。个别命令受权限/数据影响返回空或权限错误（如 report 系列仅管理员），如实说明即可。
- 查询迟到/缺勤名单时，空打卡结果不等于"没人迟到"。必须结合排班、
NotSigned、Absenteeism、无记录人员分别说明；数据缺失要标为"无记录/无法判断"，不要归为正常。
- 做部门 Top N 排名时，用户要求前 N 名就必须输出 N 个部门；无打卡记录或无可计算数据的部门按 0 或"无数据"保留在排名中，不能只输出有数据的少数部门。
summary 必须同时传 --user、--date、--stats-type（week/month），缺一返回 C0002。shift list 时间跨度不超过 7 天，最多 50 人；record get 一次只查一个用户一天。- 所有 dws 命令带
--format json，时间/日期按命令要求分别使用 YYYY-MM-DD 或 yyyy-MM-dd HH:mm:ss。
跨产品协作
- 拿到 userId 前先用
dingtalk-aisearch 解析人名
