By name: dingtalk-attendance description: 钉钉考勤（只读）。Use when 用户说 考勤/打卡记录/查打卡/查班次/考勤汇总/考勤规则/出勤情况。命令前缀：dws attendance。开源版仅支持只读查询，不支持创建班次、导入排班、修改考勤组等写操作。 cli_version: ">=0.2.14" metadata: category: product stability: experimental requires: bins: - dws
钉钉考勤 Skill
🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。20 个 dingtalk-* skill 全部通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（
dws skill setup --mode mono）。问题请提 issue 反馈。
PREREQUISITE: Read the
dws-sharedskill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. Thedwsbinary must be on PATH.
⚠️ 命令可用性可能因企业服务发现配置而异。本文档列出的命令基于 dws envelope schema 与本仓库 v1.0.30 实测，但部分命令的 cobra 子命令暴露与否还取决于你的企业 MCP gateway 是否注册了对应 tool。如果跑某条命令报
unknown command或 fall back 到父级 help，说明当前账号企业未开通该能力。实际调用前可用dws <cmd> --help或--dry-run验证。
命令参考：attendance.md。
开放平台文档 RAG / 错误码排查
- 任何产品执行中，只要用户问开放平台 API、接口参数、字段含义、权限点、回调、SDK、配额、错误码，或命令返回上游 OpenAPI/SDK 错误，必须先用
dws devdoc article search --query "<关键词>" --format json做官方文档 RAG。 - 查询词优先保留原始 API 名、能力名、权限点、完整错误码和 message；首轮形如
errcode <code> <message>，无结果再换<产品/场景> <错误码>、<接口名> 参数。 - 本地 CLI 错误（如
unknown command/unknown flag/ 认证 / recovery）仍按 rootdws/dws-shared的错误处理执行；devdoc用于开放平台业务错误码和接口语义排查。 devdoc只查钉钉开放平台开发者文档，不查业务数据；排查结论必须基于命中条目的标题、摘要或链接，不能编造错误原因或不存在的命令。
意图表
| 用户说 | 命令 |
|---|---|
| "查我 / 某人 某天的打卡" | 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 HH:mm:ss>" --stats-type week|month |
评测高频硬约束
- 开源版考勤只有
record / rules / shift / summary四个只读命令；用户提到创建班次、导入排班、加人入考勤组等写操作时，直接告知"开源版不支持"，不要伪装成功。 - 查询迟到/缺勤名单时，空打卡结果不等于"没人迟到"。必须结合排班、
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解析人名