修雨
2c10be2a1a
Publishes all 210 public built-in shortcuts as reviewed Agent-visible leaf tools across 16 product groups, with stable canonical identities, executable +shortcut CLI paths, parameter and cross-parameter constraints, selection guidance, interface metadata, and runtime-aligned safety/confirmation semantics. Catalog grows from 603 to 813 tools.
1271 lines
65 KiB
JSON
1271 lines
65 KiB
JSON
{
|
|
"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 <groupId> --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 <groupId> --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 <USER_ID> --format json",
|
|
"dws attendance selfsetting get --setting-scene fastCheck --user <USER_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 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 <USER_ID> --check-result-msg 1 --format json",
|
|
"dws attendance selfsetting save --setting-scene fastCheck --user <USER_ID> --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"
|
|
]
|
|
}
|
|
}
|
|
}
|