{ "version": 1, "source": { "kind": "explicit", "name": "dws-agent-selection/attendance", "repository": "DingTalk-Real-AI/dingtalk-workspace-cli", "channel": "open-source", "reviewed": true }, "tools": { "attendance.adjustment_get": { "agent_summary": "查询单个补卡规则详情", "use_when": [ "已取得补卡规则ID，需要查看规则详情" ], "avoid_when": [ "不知道补卡规则ID时先用 attendance adjustment search", "查询加班规则详情时使用 attendance overtime get", "查询补卡审批单记录时使用 attendance approve list" ], "examples": [ "dws attendance adjustment get --adjustment-id 12345", "dws attendance adjustment get --adjustment-id 12345 --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance adjustment get --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.adjustment_get" ] }, "attendance.adjustment_search": { "agent_summary": "查询补卡规则列表", "use_when": [ "需要查看有哪些补卡规则或筛选补卡规则" ], "avoid_when": [ "已知道补卡规则ID并要看详情时使用 attendance adjustment get", "查询加班规则时使用 attendance overtime search", "查询员工打卡/考勤记录时使用 attendance record get 或 attendance check record" ], "examples": [ "dws attendance adjustment search --page 1 --limit 20", "dws attendance adjustment search --query \"标准\" --page 1 --limit 50" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance adjustment search --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.adjustment_search" ] }, "attendance.approve_list": { "agent_summary": "查询考勤相关审批单记录", "use_when": [ "查询补卡、加班、请假、出差外出等考勤审批记录" ], "avoid_when": [ "需要获取可提交审批的模板/跳转链接时使用 attendance approve templates", "查询实际打卡记录时使用 attendance record get 或 attendance check record", "查询假期余额时使用 attendance vacation balance" ], "examples": [ "dws attendance approve list --users userId1 --types overtime,leave --start 2026-04-01 --end 2026-04-30", "dws attendance approve list --users userId1 --types trip --start 2026-04-01 --end 2026-04-30" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance approve list --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-report.md", "live-dws-schema:attendance.approve_list" ] }, "attendance.approve_templates": { "agent_summary": "查询考勤审批模板和提交入口", "use_when": [ "用户要发起补卡、请假、加班、外出或出差审批前查询可用模板" ], "avoid_when": [ "查看已存在审批单记录时使用 attendance approve list", "查询考勤记录/统计时使用 attendance record get 或 attendance summary", "配置考勤规则时使用 attendance group/globalsetting/class 相关命令" ], "examples": [ "dws attendance approve templates --type leave", "dws attendance approve templates --type REPAIR_CHECK" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance approve templates --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-report.md", "live-dws-schema:attendance.approve_templates" ] }, "attendance.batch_get_employee_shifts": { "agent_summary": "批量查询员工班次信息", "use_when": [ "需要批量查询多个员工在日期范围内的考勤班次（userId/workDate/checkType/planCheckTime/isRest）时" ], "avoid_when": [ "要查实际排班记录时改用 schedule get", "要查班次定义时改用 class search/get", "要查考勤组规则时改用 rules" ], "examples": [ "dws attendance shift list --users userId1,userId2 --start 2026-03-03 --end 2026-03-07" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance shift list --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-schedule.md", "live-dws-schema:attendance.batch_get_employee_shifts" ] }, "attendance.boss_check": { "agent_summary": "管理员修正员工打卡结果", "use_when": [ "管理员明确要求修正员工打卡时间或打卡结果，且已确认 planId/resultId 与变更内容时" ], "avoid_when": [ "只查询打卡记录时使用 attendance check record/check result", "查询考勤统计时使用 attendance summary", "用户尚未确认改签目标与结果时不要执行" ], "examples": [ "dws attendance boss-check --plan-id 123456 --time \"2025-04-21 08:30\"", "dws attendance boss-check --result-id 789012 --result Normal" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance boss-check --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.boss_check" ] }, "attendance.check_record": { "agent_summary": "查询打卡记录", "use_when": [ "查询员工打卡流水或打卡记录" ], "avoid_when": [ "查询考勤详情时使用 attendance record get", "查询考勤统计摘要时使用 attendance summary", "修改打卡结果时使用 attendance boss-check" ], "examples": [ "dws attendance check record --users userId1 --start 2026-04-01 --end 2026-04-30" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance check record --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-report.md", "live-dws-schema:attendance.check_record" ] }, "attendance.check_result": { "agent_summary": "查询打卡结果", "use_when": [ "查询员工打卡结果或考勤结果" ], "avoid_when": [ "查询原始打卡流水时使用 attendance check record", "查询统计摘要时使用 attendance summary", "修改打卡结果时使用 attendance boss-check" ], "examples": [ "dws attendance check result --users userId1,userId2 --start 2026-04-01 --end 2026-04-30 --limit 50" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance check result --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-report.md", "live-dws-schema:attendance.check_result" ] }, "attendance.checkin_records": { "agent_summary": "查询打卡流水记录", "use_when": [ "查询员工打卡流水、定位或打卡时间记录" ], "avoid_when": [ "查询考勤汇总时使用 attendance summary", "查询班次/排班时使用 attendance shift list 或 schedule get", "修改打卡记录时使用 attendance boss-check" ], "examples": [ "dws attendance checkin records --operator-corp-id corp001 --operator-staff-id op001 --staff-ids user001,user002 --start \"2026-04-01 00:00:00\" --end \"2026-04-07 00:00:00\"", "dws attendance checkin records --operator-corp-id corp001 --operator-staff-id op001 --staff-ids user001,user002 --start \"2026-04-01 00:00:00\" --end \"2026-04-07 00:00:00\" --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance checkin records --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-report.md", "live-dws-schema:attendance.checkin_records" ] }, "attendance.class_create": { "agent_summary": "创建班次定义", "use_when": [ "需要新增班次及上下班时间规则，且名称与 class-vo 已确认时" ], "avoid_when": [ "查询已有班次时使用 attendance class search/get", "修改已有班次时使用 attendance class update", "导入员工排班时使用 attendance schedule import" ], "examples": [ "dws attendance class create --name \"早班\" --class-vo '{\"sections\":[{\"times\":[{\"checkType\":\"OnDuty\",\"checkTime\":\"08:00\",\"across\":0},{\"checkType\":\"OffDuty\",\"checkTime\":\"17:00\",\"across\":0}]}]}' --timeout 10" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance class create --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.class_create" ] }, "attendance.class_get": { "agent_summary": "查询单个班次定义详情", "use_when": [ "已取得班次ID，需要查看班次配置" ], "avoid_when": [ "不知道班次ID时先用 attendance class search", "查询员工排班记录时使用 attendance schedule get", "修改班次定义时使用 attendance class update" ], "examples": [ "dws attendance class get --class-id 1170996821", "dws attendance class get --class-id 1170996821 --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance class get --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.class_get" ] }, "attendance.class_search": { "agent_summary": "查询班次定义列表", "use_when": [ "搜索或列出可用班次/班次ID" ], "avoid_when": [ "已知道班次ID并要看详情时使用 attendance class get", "查询员工排班记录时使用 attendance schedule get", "创建或修改班次定义时使用 attendance class create/update" ], "examples": [ "dws attendance class search", "dws attendance class search --query \"早班\" --filter-type MINE_OWN" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance class search --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.class_search" ] }, "attendance.class_update": { "agent_summary": "更新班次定义", "use_when": [ "需要修改已有班次的名称、上下班时间或规则，且 classId 与变更内容已确认时" ], "avoid_when": [ "查询班次详情时使用 attendance class get", "创建新班次时使用 attendance class create", "调整员工排班时使用 attendance schedule import" ], "examples": [ "dws attendance class update --class-id 1170996821 --name \"新早班\" --timeout 10", "dws attendance class update --class-id 1170996821 --class-vo '{\"sections\":[{\"times\":[{\"checkType\":\"OnDuty\",\"checkTime\":\"08:30\",\"across\":0},{\"checkType\":\"OffDuty\",\"checkTime\":\"17:30\",\"across\":0}]}]}' --timeout 10" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance class update --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.class_update" ] }, "attendance.get_attendance_summary": { "agent_summary": "查询个人考勤统计摘要", "use_when": [ "需要查看员工出勤/异常/请假等考勤统计摘要时" ], "avoid_when": [ "要看单日明细时改用 record get", "要看打卡流水时改用 check record" ], "examples": [ "dws attendance summary --user USER_ID --date 2026-03-12 --stats-type week", "dws attendance summary --user USER_ID --date \"2026-03-12 15:00:00\" --stats-type month" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance summary --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-report.md", "live-dws-schema:attendance.get_attendance_summary" ] }, "attendance.get_user_attendance_record": { "agent_summary": "查询个人考勤详情", "use_when": [ "需要查询指定用户某一天的考勤详情（打卡、班次、考勤组、工时、加班等，受权限限制）时" ], "avoid_when": [ "要统计摘要时改用 summary", "要改打卡结果时改用 boss-check" ], "examples": [ "dws attendance record get --user 011769261608 --date 2026-03-08", "dws attendance record get --user USER_ID --date 2026-03-08" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance record get --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-report.md", "live-dws-schema:attendance.get_user_attendance_record" ] }, "attendance.globalsetting_get": { "agent_summary": "查询企业全局考勤设置", "use_when": [ "管理员查看企业级打卡提醒、极速打卡等全局设置" ], "avoid_when": [ "修改全局设置时使用 attendance globalsetting save", "查看个人设置时使用 attendance selfsetting get", "查看考勤组规则时使用 attendance group get/rules" ], "examples": [ "dws attendance globalsetting get --scope 企业 --setting-scene checkRemind --format json", "dws attendance globalsetting get --scope 全公司 --setting-scene bossAttendStatNotify --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance globalsetting get --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.globalsetting_get" ] }, "attendance.globalsetting_save": { "agent_summary": "更新企业全局考勤设置", "use_when": [ "管理员明确要求修改企业级打卡提醒、极速打卡等全局设置，且 scope/scene 与变更值已确认时" ], "avoid_when": [ "只查看全局设置时使用 attendance globalsetting get", "修改个人设置时使用 attendance selfsetting save", "修改考勤组配置时使用 attendance group update" ], "examples": [ "dws attendance globalsetting save --scope 企业 --setting-scene checkRemind --check-remind-corp=true", "dws attendance globalsetting save --scope 全公司 --setting-scene fastCheck --fast-check-corp=false" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance globalsetting save --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.globalsetting_save" ] }, "attendance.group_create": { "agent_summary": "创建考勤组", "use_when": [ "需要新建考勤组并配置规则，且名称、类型与 group-vo 已确认时" ], "avoid_when": [ "查询已有考勤组时使用 attendance group search/get", "修改已有考勤组时使用 attendance group update", "仅修改成员时使用 attendance group update-members" ], "examples": [ "dws attendance group create --name \"研发考勤组\" --type FIXED --group-vo '{\"defaultClassId\":1170996821,\"workDayClassList\":[0,1170996821,0,0,0,0,0]}' --timeout 10", "dws attendance group create --name \"自由工时分组\" --type NONE --timeout 10" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance group create --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.group_create" ] }, "attendance.group_filtered_get": { "agent_summary": "查询考勤组指定字段子集", "use_when": [ "只需要考勤组成员、打卡地址、蓝牙等部分字段，减少返回体积" ], "avoid_when": [ "需要完整考勤组配置时使用 attendance group get", "不知道考勤组ID时先用 attendance group search", "需要修改成员时使用 attendance group update-members" ], "examples": [ "dws attendance group filtered-get --group-id --member --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance group filtered-get --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.group_filtered_get" ] }, "attendance.group_get": { "agent_summary": "查询考勤组完整详情", "use_when": [ "已取得考勤组ID，需要查看完整配置" ], "avoid_when": [ "不知道考勤组ID时先用 attendance group search", "只需要成员/地址等子集时使用 attendance group filtered-get", "修改考勤组配置时使用 attendance group update" ], "examples": [ "dws attendance group get --group-id --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance group get --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.group_get" ] }, "attendance.group_search": { "agent_summary": "查询考勤组列表", "use_when": [ "按权限或条件查看考勤组简要信息" ], "avoid_when": [ "已知道考勤组ID并要看详情时使用 attendance group get", "只需要部分字段时使用 attendance group filtered-get", "创建/修改考勤组时使用 attendance group create/update" ], "examples": [ "dws attendance group search --query \"<考勤组名称>\" --type TURN --format json", "dws attendance group search --query \"研发组\" --type TURN --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance group search --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.group_search" ] }, "attendance.group_update": { "agent_summary": "更新考勤组配置", "use_when": [ "需要修改已有考勤组的规则、班次、位置或范围，且 groupId 与变更内容已确认时" ], "avoid_when": [ "查询考勤组详情时使用 attendance group get", "只调整成员时使用 attendance group update-members", "创建新考勤组时使用 attendance group create" ], "examples": [ "dws attendance group update --group-id 123456 --name \"研发考勤组\" --timeout 10", "dws attendance group update --group-id 123456 --owner userId1 --timeout 10" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance group update --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.group_update" ] }, "attendance.group_update_members": { "agent_summary": "增删考勤组成员", "use_when": [ "需要向考勤组添加或移除成员，且 groupId 与成员列表已确认时" ], "avoid_when": [ "只查询成员信息时使用 attendance group filtered-get 或 group get", "修改考勤组规则配置时使用 attendance group update", "创建新考勤组时使用 attendance group create" ], "examples": [ "dws attendance group update-members --group-id 123456 --add-users userId1,userId2", "dws attendance group update-members --group-id 123456 --remove-users userId1" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance group update-members --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.group_update_members" ] }, "attendance.overtime_get": { "agent_summary": "查询单个加班规则详情", "use_when": [ "已取得加班规则ID，需要查看规则详情" ], "avoid_when": [ "不知道加班规则ID时先用 attendance overtime search", "查询补卡规则详情时使用 attendance adjustment get", "查询员工班次时使用 attendance shift list" ], "examples": [ "dws attendance overtime get --overtime-id 12345", "dws attendance overtime get --overtime-id 12345 --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance overtime get --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.overtime_get" ] }, "attendance.overtime_search": { "agent_summary": "查询加班规则列表", "use_when": [ "需要查看可用加班规则或筛选加班规则" ], "avoid_when": [ "已知道加班规则ID并要看详情时使用 attendance overtime get", "查询补卡规则时使用 attendance adjustment search", "查询加班审批单记录时使用 attendance approve list" ], "examples": [ "dws attendance overtime search --page 1 --limit 20", "dws attendance overtime search --query \"节假日\" --page 1 --limit 50" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance overtime search --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.overtime_search" ] }, "attendance.query_attendance_group_or_rules": { "agent_summary": "查询考勤组与考勤规则", "use_when": [ "需要回答「我属于哪个考勤组/打卡范围/弹性工时怎么算」等规则概览问题时" ], "avoid_when": [ "要完整考勤组配置时改用 group get", "要补卡/加班规则列表时改用 adjustment/overtime search" ], "examples": [ "dws attendance rules --date <今天日期> --format json", "dws attendance rules --date 2026-03-14" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance rules --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.query_attendance_group_or_rules" ] }, "attendance.report_columns": { "agent_summary": "查询可查看的考勤报表字段", "use_when": [ "查看操作者有权限查询的考勤报表字段" ], "avoid_when": [ "查询报表数据时使用 attendance report query-data", "查询假期数据时使用 attendance report query-leave", "查询个人考勤明细时使用 attendance record get" ], "examples": [ "dws attendance report columns" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance report columns --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-report.md", "live-dws-schema:attendance.report_columns" ] }, "attendance.report_query_data": { "agent_summary": "查询考勤报表数据", "use_when": [ "按字段查询考勤报表数据并进行权限过滤" ], "avoid_when": [ "查询可用字段时先用 attendance report columns", "查询假期数据时使用 attendance report query-leave", "查询个人单日明细时使用 attendance record get" ], "examples": [ "dws attendance report query-data --users userId1,userId2 --columns 1001,1002 --start \"2026-03-01 00:00:00\" --end \"2026-03-31 23:59:59\"", "dws attendance report query-data --users userId1,userId2 --columns 1001,1002 --start \"2026-03-01 00:00:00\" --end \"2026-03-31 23:59:59\" --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance report query-data --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-report.md", "live-dws-schema:attendance.report_query_data" ] }, "attendance.report_query_leave": { "agent_summary": "查询假期报表数据", "use_when": [ "查询用户假期/请假相关报表数据" ], "avoid_when": [ "查询假期余额时使用 attendance vacation balance", "查询假期余额变更记录时使用 attendance vacation records", "查询通用考勤报表时使用 attendance report query-data" ], "examples": [ "dws attendance report query-leave --users userId1,userId2 --leave-names 年假,病假 --start \"2026-03-01 00:00:00\" --end \"2026-03-31 23:59:59\"", "dws attendance report query-leave --users userId1,userId2 --leave-names 年假,病假 --start \"2026-03-01 00:00:00\" --end \"2026-03-31 23:59:59\" --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance report query-leave --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-report.md", "live-dws-schema:attendance.report_query_leave" ] }, "attendance.schedule_get": { "agent_summary": "查询员工排班记录", "use_when": [ "查询指定员工在日期范围内的排班记录" ], "avoid_when": [ "查询班次定义时使用 attendance class get/search", "批量查询员工班次结果时使用 attendance shift list", "导入或修改排班时使用 attendance schedule import" ], "examples": [ "dws attendance schedule get --userIdList 03642229451220076 --workDateBegin 2026-05-13 --workDateEnd 2026-05-13 -f json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance schedule get --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-schedule.md", "live-dws-schema:attendance.schedule_get" ] }, "attendance.schedule_import": { "agent_summary": "导入排班制考勤组排班记录", "use_when": [ "需要向排班制考勤组批量导入或覆盖员工排班，且 groupId 与 scheduleVOS 已确认时" ], "avoid_when": [ "仅查看排班时使用 attendance schedule get 或 attendance shift list", "查询班次定义时使用 attendance class search/get", "不确定 groupId/classId/workDate 时先查询考勤组和班次" ], "examples": [ "dws attendance schedule import --groupId 123456 --scheduleVOS '[{\"userId\":\"user001\",\"workDate\":\"2026-04-22 09:00:00\",\"classId\":123,\"isRest\":\"N\"}]'" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance schedule import --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-schedule.md", "live-dws-schema:attendance.schedule_import" ] }, "attendance.selfsetting_get": { "agent_summary": "查询个人考勤设置", "use_when": [ "查看某个员工的个人打卡提醒、极速打卡、结果通知等设置" ], "avoid_when": [ "修改个人设置时使用 attendance selfsetting save", "查询企业全局设置时使用 attendance globalsetting get", "查询个人考勤记录时使用 attendance record get" ], "examples": [ "dws attendance selfsetting get --setting-scene checkRemind --user --format json", "dws attendance selfsetting get --setting-scene fastCheck --user --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance selfsetting get --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.selfsetting_get" ] }, "attendance.selfsetting_save": { "agent_summary": "更新个人考勤设置", "use_when": [ "需要修改员工个人打卡提醒、极速打卡或结果通知设置，且 scene 与变更值已确认时" ], "avoid_when": [ "只查看个人设置时使用 attendance selfsetting get", "修改企业全局设置时使用 attendance globalsetting save", "查询考勤记录时使用 attendance record get" ], "examples": [ "dws attendance selfsetting save --setting-scene checkResultNotify --user --check-result-msg 1 --format json", "dws attendance selfsetting save --setting-scene fastCheck --user --onduty-check-type 3 --voice-remind-switch=true --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance selfsetting save --help", "skills/mono/references/products/attendance.md", "live-dws-schema:attendance.selfsetting_save" ] }, "attendance.vacation_balance": { "agent_summary": "查询员工假期余额", "use_when": [ "查询指定员工的年假、调休等假期余额" ], "avoid_when": [ "查询假期余额变更明细时使用 attendance vacation records", "查询假期类型时使用 attendance vacation types", "修改余额时使用 attendance vacation save-balance" ], "examples": [ "dws attendance vacation balance --users userId1,userId2 --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890", "dws attendance vacation balance --users userId1,userId2 --leave-code <假期类型code> --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance vacation balance --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-vacation.md", "live-dws-schema:attendance.vacation_balance" ] }, "attendance.vacation_records": { "agent_summary": "查询假期余额变更记录", "use_when": [ "查询员工假期余额的增减流水或变更历史" ], "avoid_when": [ "只看当前余额时使用 attendance vacation balance", "查询假期类型时使用 attendance vacation types", "修改余额时使用 attendance vacation save-balance" ], "examples": [ "dws attendance vacation records --user USER_ID --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --start 2026-04-01 --end 2026-04-22", "dws attendance vacation records --user USER_ID --leave-code <假期类型code> --start 2026-04-01 --end 2026-04-22 --format json" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance vacation records --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-vacation.md", "live-dws-schema:attendance.vacation_records" ] }, "attendance.vacation_save_balance": { "agent_summary": "调整员工假期余额", "use_when": [ "管理员明确要求设置指定员工假期余额（SET 替换而非累加），且 target/leave-code/num/reason 已确认时" ], "avoid_when": [ "只查询余额时使用 attendance vacation balance", "查询变更流水时使用 attendance vacation records", "修改假期类型/规则时使用 attendance vacation update-type" ], "examples": [ "dws attendance vacation save-balance --target user001 --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --num 8 --reason \"年度发放\"", "dws attendance vacation save-balance --target user001 --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --num 8 --reason \"年度发放\" --start 2024-01-01 --end 2024-12-31" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance vacation save-balance --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-vacation.md", "live-dws-schema:attendance.vacation_save_balance" ] }, "attendance.vacation_types": { "agent_summary": "查询可用假期类型", "use_when": [ "查看当前用户可用的假期规则/假期类型列表" ], "avoid_when": [ "查询员工假期余额时使用 attendance vacation balance", "修改假期规则时使用 attendance vacation update-type", "修改假期余额时使用 attendance vacation save-balance" ], "examples": [ "dws attendance vacation types" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance vacation types --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-vacation.md", "live-dws-schema:attendance.vacation_types" ] }, "attendance.vacation_update_type": { "agent_summary": "更新假期类型规则", "use_when": [ "管理员明确要求修改已有假期规则或假期类型配置，且 leave-code 与变更字段已确认时" ], "avoid_when": [ "只查询假期类型时使用 attendance vacation types", "调整员工假期余额时使用 attendance vacation save-balance", "查询假期报表时使用 attendance report query-leave" ], "examples": [ "dws attendance vacation update-type --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --name \"事假（修改版）\"", "dws attendance vacation update-type --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --unit hour --per-hours 8" ], "reviewed": true, "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance vacation update-type --help", "skills/mono/references/products/attendance.md", "skills/mono/references/products/attendance-vacation.md", "live-dws-schema:attendance.vacation_update_type" ] }, "attendance.shortcut_check_result": { "agent_summary": "查询用户打卡结果（迟到/早退/缺卡等）", "use_when": [ "当你需要批量统计一批员工在某段时间的打卡结果（正常/迟到/早退/缺卡等判定结论）时使用，例如做月度考勤汇总或异常人员排查；输入多个 userId（最多 100 人）和不超过 1 个月的日期区间，返回每人每天的打卡结果状态，支持分页。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +check-result --users userId1,userId2 --start 2026-04-01 --end 2026-04-30 --limit 50" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_check_result", "cobra-help:dws attendance +check-result", "ShortcutRegistry:attendance +check-result" ] }, "attendance.shortcut_check_record": { "agent_summary": "查询用户打卡流水（打卡时间/地点/定位方式）", "use_when": [ "当你要查看员工每一次实际打卡的原始记录（具体打卡时刻、打卡地点、定位/Wifi/蓝牙等方式）而不是判定结论时使用，例如核实某人是否在指定地点打卡；输入 userId 列表和不超过 1 个月的日期区间，返回逐条打卡流水。与 +check-result 的区别是这里返回明细流水而非迟到早退结论。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +check-record --users userId1 --start 2026-04-01 --end 2026-04-30" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_check_record", "cobra-help:dws attendance +check-record", "ShortcutRegistry:attendance +check-record" ] }, "attendance.shortcut_list_approve": { "agent_summary": "查询用户考勤审批单（补卡/加班/请假/出差外出）", "use_when": [ "当你想查看某些员工已提交的考勤类审批单（加班、请假、出差外出、补卡）时使用，例如核对某人这段时间请了几次假或有没有补卡审批；输入 userId 列表、审批类型（overtime/加班、leave/请假、trip/出差外出、patch/补卡）和日期区间，返回匹配的审批单记录。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +list-approve --users userId1 --types overtime,leave --start 2026-04-01 --end 2026-04-30" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_list_approve", "cobra-help:dws attendance +list-approve", "ShortcutRegistry:attendance +list-approve" ] }, "attendance.shortcut_get_approve_template": { "agent_summary": "查询补卡/请假/加班/外出/出差审批提交链接", "use_when": [ "当用户想自己发起一条考勤审批（补卡、请假、加班、外出、出差）、需要拿到对应审批表单的提交入口链接时使用；输入审批类型（如 leave/请假），返回可直接打开填写并提交的审批链接。本命令只返回链接、不代替用户提交审批。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +get-approve-template --type leave" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_get_approve_template", "cobra-help:dws attendance +get-approve-template", "ShortcutRegistry:attendance +get-approve-template" ] }, "attendance.shortcut_get_schedule": { "agent_summary": "获取指定用户一段时间内的排班记录", "use_when": [ "当你要查看排班制考勤组下员工在某段时间的排班记录（含排班 id、班次、是否休息）时使用，尤其是需要拿到排班 id 用于后续 BOSS 改签打卡（+boss-check）的场景；输入 userId 列表和起止时间，返回逐日排班明细。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +get-schedule --users user001,user002 --start 2026-04-01 --end 2026-04-30" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_get_schedule", "cobra-help:dws attendance +get-schedule", "ShortcutRegistry:attendance +get-schedule" ] }, "attendance.shortcut_search_class": { "agent_summary": "查询当前用户可管理的班次详情列表", "use_when": [ "当你要浏览或按名称查找当前用户能管理的班次、以便拿到班次 ID 用于建组、排班或改班次时使用；可选按班次名关键字模糊搜索、按 ALL/我负责的过滤并分页，返回班次列表及详情。要看某个具体班次的完整配置用 +get-class。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +search-class --query \"早班\" --filter-type MINE_OWN" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_search_class", "cobra-help:dws attendance +search-class", "ShortcutRegistry:attendance +search-class" ] }, "attendance.shortcut_get_adjustment_rule": { "agent_summary": "根据补卡规则主键 ID 查询补卡规则详情", "use_when": [ "当你已知某条补卡规则的主键 ID、想查看它的具体规则内容（每月可补卡次数、时限、适用范围等）时使用；输入 adjustmentId，返回该补卡规则的完整详情。不知道 ID 时先用 +search-adjustment-rule 列出。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +get-adjustment-rule --adjustment-id 12345" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_get_adjustment_rule", "cobra-help:dws attendance +get-adjustment-rule", "ShortcutRegistry:attendance +get-adjustment-rule" ] }, "attendance.shortcut_search_adjustment_rule": { "agent_summary": "查询当前用户可管理的补卡规则列表", "use_when": [ "当你要浏览或按名称查找当前用户可管理的补卡规则、以便拿到规则 ID 做进一步查看时使用；可选按规则名关键字模糊搜索并分页，返回补卡规则列表。要看某条规则的完整内容用 +get-adjustment-rule。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +search-adjustment-rule --query \"标准\" --page 1 --limit 50" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_search_adjustment_rule", "cobra-help:dws attendance +search-adjustment-rule", "ShortcutRegistry:attendance +search-adjustment-rule" ] }, "attendance.shortcut_get_overtime_rule": { "agent_summary": "根据加班规则主键 ID 查询加班规则详情", "use_when": [ "当你已知某条加班规则的主键 ID、想查看它的具体内容（工作日/休息日/节假日加班计算方式、适用范围等）时使用；输入 overtimeId，返回该加班规则的完整详情。不知道 ID 时先用 +search-overtime-rule 列出。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +get-overtime-rule --overtime-id 12345" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_get_overtime_rule", "cobra-help:dws attendance +get-overtime-rule", "ShortcutRegistry:attendance +get-overtime-rule" ] }, "attendance.shortcut_search_overtime_rule": { "agent_summary": "查询当前用户可管理的加班规则列表", "use_when": [ "当你要浏览或按名称查找当前用户可管理的加班规则、以便拿到规则 ID 做进一步查看时使用；可选按规则名关键字模糊搜索并分页，返回加班规则列表。要看某条规则的完整内容用 +get-overtime-rule。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +search-overtime-rule --query \"节假日\" --page 1 --limit 50" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_search_overtime_rule", "cobra-help:dws attendance +search-overtime-rule", "ShortcutRegistry:attendance +search-overtime-rule" ] }, "attendance.shortcut_search_group": { "agent_summary": "查询当前用户可管理的考勤组列表", "use_when": [ "当你要浏览或按名称查找当前用户可管理的考勤组、以便拿到考勤组 ID 用于查看详情、改成员或改配置时使用；可选按名称关键字、考勤组类型（固定班制/排班制/自由工时）过滤，并可选带出定位/Wifi/蓝牙信息，分页返回考勤组简要列表。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +search-group --query \"研发\" --type FIXED --limit 50" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_search_group", "cobra-help:dws attendance +search-group", "ShortcutRegistry:attendance +search-group" ] }, "attendance.shortcut_get_summary": { "agent_summary": "查询某个人的考勤统计摘要（周/月）", "use_when": [ "当你想快速了解某个人一周或一月的考勤汇总（出勤天数、迟到早退次数、加班、请假时长等统计口径）而不是逐天明细时使用；输入 userId、所在周期内的任意日期和统计类型（week/month），返回该周期的考勤统计摘要。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +get-summary --user USER_ID --date 2026-03-12 --stats-type week" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_get_summary", "cobra-help:dws attendance +get-summary", "ShortcutRegistry:attendance +get-summary" ] }, "attendance.shortcut_get_self_setting": { "agent_summary": "查询个人规则设置（打卡提醒/极速打卡/缺卡提醒等）", "use_when": [ "当你想查看某个用户在指定场景下的个人考勤规则开关配置（如打卡提醒、极速打卡、缺卡提醒、考勤结果通知等是否开启）时使用；输入设置场景 settingScene 和用户 userId，返回该用户对应场景的个人设置。查企业全局设置用 +get-global-setting。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +get-self-setting --setting-scene checkRemind --user USER_ID" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_get_self_setting", "cobra-help:dws attendance +get-self-setting", "ShortcutRegistry:attendance +get-self-setting" ] }, "attendance.shortcut_query_report_data": { "agent_summary": "根据字段查询考勤报表数据（仅管理员）", "use_when": [ "当你要按指定考勤字段导出/查询一批员工在某时间段的报表数值（如各人的出勤天数、迟到次数、加班时长）时使用，常用于做考勤汇总或核算；输入 userId 列表（最多 20 人）、字段 ID 列表（来自 +list-report-columns）和不超过 32 天的时间区间，返回对应字段的数据。仅管理员可用。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +query-report-data --users userId1,userId2 --columns 1001,1002 --start \"2026-03-01 00:00:00\" --end \"2026-03-31 23:59:59\"" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_query_report_data", "cobra-help:dws attendance +query-report-data", "ShortcutRegistry:attendance +query-report-data" ] }, "attendance.shortcut_list_leave_types": { "agent_summary": "查询当前用户可用的假期规则列表", "use_when": [ "当你想知道企业有哪些假期类型（年假、事假、病假等）及其对应的假期编码 code、单位、是否带薪时使用，通常是查余额或改假期规则前先拿到 leaveCode；无需参数，返回当前用户可用的假期规则列表。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +list-leave-types" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_list_leave_types", "cobra-help:dws attendance +list-leave-types", "ShortcutRegistry:attendance +list-leave-types" ] }, "attendance.shortcut_get_leave_records": { "agent_summary": "查询指定员工的假期余额变更记录", "use_when": [ "当你想追溯某个员工假期额度的变动流水（何时发放、扣减、因请假消耗多少）以核对余额来龙去脉时使用；输入单个 userId、日期区间，可选假期 code（不传查所有假期），返回该员工在该时间段的余额变更记录。只想看当前余额用 +get-leave-balance。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +get-leave-records --user USER_ID --leave-code a1b2c3d4-e5f6-7890-abcd-ef1234567890 --start 2026-04-01 --end 2026-04-22" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_get_leave_records", "cobra-help:dws attendance +get-leave-records", "ShortcutRegistry:attendance +get-leave-records" ] }, "attendance.shortcut_get_checkin_record": { "agent_summary": "查询指定员工一段时间内的签到记录", "use_when": [ "当你要查看员工的外勤/移动办公签到记录（signin/checkin，区别于考勤打卡）时使用，例如核实业务员的拜访签到轨迹；需提供操作者企业 ID 与员工 ID、目标员工 ID 列表（最多 100 人）以及不超过 7 天的时间区间，返回这些人的签到明细。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +get-checkin-record --operator-corp-id dingXXX --operator-staff-id op001 --staff-ids user001,user002 --start \"2026-04-01 00:00:00\" --end \"2026-04-07 00:00:00\"" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_get_checkin_record", "cobra-help:dws attendance +get-checkin-record", "ShortcutRegistry:attendance +get-checkin-record" ] }, "attendance.shortcut_my_attendance": { "agent_summary": "查我今天的考勤打卡记录（打卡流水，自动解析当前用户）", "use_when": [ "当你想快速看自己今天的打卡流水（几点上下班打卡、打卡地址/定位方式）、又不想先查自己的 userId 再手动填写今天的起止时间时使用；内部先取当前登录用户的 userId，再按本地时区算出今天 00:00 到次日 00:00 的时间窗，最后查询你今天的打卡流水记录。只读操作，不会修改任何考勤数据；今天若还没有任何打卡则返回空结果。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +my-attendance" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_my_attendance", "cobra-help:dws attendance +my-attendance", "ShortcutRegistry:attendance +my-attendance" ] }, "attendance.shortcut_this_month": { "agent_summary": "查我本月的考勤打卡记录（打卡流水，自动解析当前用户）", "use_when": [ "当你想快速看自己本月的打卡流水（几点上下班打卡、打卡地址/定位方式）、又不想先查自己的 userId 再手动填写本月的起止时间时使用；内部先取当前登录用户的 userId，再按本地时区算出本月 1 号 00:00 到下月 1 号 00:00 的时间窗，最后查询你本月的打卡流水记录。只读操作，不会修改任何考勤数据；本月若还没有任何打卡则返回空结果。" ], "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令" ], "examples": [ "dws attendance +this-month" ], "reviewed": true, "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.", "source_refs": [ "internal/cli/schema_command_registry.json#attendance.shortcut_this_month", "cobra-help:dws attendance +this-month", "ShortcutRegistry:attendance +this-month" ] } }, "products": { "attendance": { "agent_summary": "查询考勤记录、排班、班次、考勤组、审批、报表、个人规则和假期，并执行经确认的考勤配置变更。", "use_when": [ "用户要查询或管理钉钉考勤数据、规则、排班、考勤组、审批表单或假期余额。" ], "avoid_when": [ "用户只需处理普通日历日程、非考勤类活动签到或通用审批流状态，而不是钉钉考勤业务。" ], "reviewed": true, "review_reason": "依据 reviewed CommandRegistry、真实 Cobra help 与 mono 产品参考，审阅并固化 attendance 产品的 Agent 选择语义。", "source_refs": [ "internal/cli/schema_command_registry.json", "cobra-help:dws attendance --help", "skills/mono/references/products/attendance.md" ] } } }