github/dingtalk-workspace-cli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
codex/cloud-release-withdrawal
dingtalk-workspace-cli/internal/cli/schema_hints/selection/attendance.json
T
玉澜andCursor 5856a897d1 feat(schema): split human hints into metadata and selection 
Own safety/gates/parameters in metadata/ and Agent prose in selection/,
drop the monolithic Manual file, and keep confirmation aligned with
per-tool runtime_gate.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-14 13:40:09 +08:00

910 lines
42 KiB
JSON
Raw Permalink Blame History

{
"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"
]
}
},
"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"
]
}
}
}
Reference in New Issue View Git Blame Copy Permalink