{
  "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"
      ]
    }
  }
}