# Moka Attendance Admin > 面向考勤负责人与人事管理角色的假勤管理查询（普通员工账号无相应权限）。使用当前平台提供的 Moka 连接器查询员工出勤报表（日历/月报/日报/补卡）、假期账户与请假辅助、加班详情与试算、已发布排班、出差与外出记录。当用户以管理视角查询或核对员工假勤数据时使用。 - Skill: `ahang1598/moka-attendance-admin` (Agent Skill) - Install (CLI): `npx skillmds@latest add ahang1598/moka-attendance-admin` - Raw SKILL.md: https://api.skillmd.com/api/skills/ahang1598/moka-attendance-admin/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: ahang1598 (https://skillmd.com/u/ahang1598) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/ahang1598/moka-attendance-admin --- # Moka 假勤管理 以考勤负责人视角查询员工假勤数据，全部只读。只编排以下五个工具： - `mcp__moka__get_attendance_reports` - `mcp__moka__get_leave_account_details` - `mcp__moka__get_overtime_details` - `mcp__moka__get_shift_schedules` - `mcp__moka__get_business_travel_records` ## 选择工具 出勤报表用 `mcp__moka__get_attendance_reports`，按视图选能力： - 出勤日历：按月概览、按天反查账期、单日考勤明细（打卡、单据、补卡逐段展开）。 - 考勤月报：先解析月报配置，再查单人月报详情、当前可变更字段、确认详情、封存状态与封存差异。 - 考勤日报：先解析日报配置，再查单日明细，或从月报的某个字段穿透到日报。 - 补卡：补卡记录、补卡月历、某天可补卡时段、当天补卡规则。 假期账户与请假辅助用 `mcp__moka__get_leave_account_details`，分两个视图： - 账户视图查假期账户，链路是：先按名称消歧假种 → 按人聚合的余额列表 → 单员工单假种的账户明细 → 用假记录；离职场景另有离职清算明细。 - 辅助视图做请假前的只读辅助：某员工的可用假种与余额、请假时长试算、某日可用时间范围、假种时长上限、假种优先级校验。 加班用 `mcp__moka__get_overtime_details`： - 单条记录：加班记录详情（仅支持按打卡时长结算的记录）、结算说明（结算方式、休息扣除、取整规则、单日上限等完整链路，用来解释「为什么少算/没算」）。 - 申请前辅助：按时段与打卡试算加班时长、员工某日的加班单位与补偿方式、可申请加班时段。 - 集体加班：每人时长试算（含告警与阻断）、审批风险检查、规则配置、申请表单字段标识。 排班用 `mcp__moka__get_shift_schedules`，仅覆盖已发布的排班数据： - 先按排班组名称消歧换取 `ruleId`，再按员工视角（每人每天排了哪个班次）或班次视角（每个班次每天排了哪些员工）查看某月排班。 - 排班变更记录（谁在何时把谁的班次改成了什么）与换班申请记录（谁和谁换班、审批到哪一步）分页查询。 出差与外出用 `mcp__moka__get_business_travel_records`： - 出差视图：出差记录分页列表、某员工一段出差时间与已有行程是否重叠的预检、出差城市搜索与地点逐层下钻、员工考勤规则确认。 - 外出视图：外出记录分页列表、按部门查某一天团队外出与出差的合并记录、一段外出的时长试算。 易混辨析：加班的「记录详情/结算说明」只针对已存在的单条记录，需要先有记录标识；「试算」类能力面向尚未提交的时段，两者不要混用。排班查询不含未发布的草稿排班。 员工询问自己本人的考勤、假期余额、加班记录或工资等自助事务，或需要浏览请假/加班/打卡等记录的全量列表、花名册名单时，不要用本技能的工具。这些问题应由当前可用的其他 Moka 工具处理。 ## 调用规范 1. 使用 Moka 连接器提供的工具（本技能内的工具名即实际注册名）；连接器未安装或未连接时如实告知用户，不改用其他来源。 2. 通过当前平台的工具发现能力读取实时 description 与参数 Schema，以它们为入参事实源。 3. 只传用户明确给出的条件，不自行扩展员工、部门、日期或筛选范围。 4. 句柄先取后用，禁止手写或猜测： - 员工与部门标识必须来自本技能工具的返回项，或来自花名册、组织查询等能力的查询结果。 - 月报配置标识与日报配置标识分别来自 `mcp__moka__get_attendance_reports` 对应视图的解析操作，两者语义不同，不可混用。 - 假种标识来自 `mcp__moka__get_leave_account_details` 的假种消歧或可用假种返回项。 - 排班组 `ruleId` 来自 `mcp__moka__get_shift_schedules` 的排班组消歧操作，必须原样传递。 - 加班记录标识来自加班记录列表的查询结果。 5. 消歧结果不唯一时（月报/日报配置、假种、排班组匹配到多个候选），必须让用户从候选中选择，禁止替用户猜测。 6. 日期用 YYYY-MM-DD、月份用 YYYY-MM；相对日期先按用户所在时区换算成绝对日期再调用，回答里说明实际查询的日期或区间。月报账期以配置为准，可能不是自然月。 7. 补卡记录查询必须使用用户明确给出或确认的起止日期，禁止默认查全年。 8. 出差行程重叠预检的起止时间必须使用相同表示法：都用具体时刻，或都用上午/下午，不能混用。 9. 时长试算需要的假种计时单位等伴随参数，从可用假种返回项中原样透传，不要改写。 ## 结果与权限 - 空结果一律按「未返回数据」处理：可能是条件过严或范围内确实没有记录，不得反推为无权限，也不要断言「确实没有」。 - 工具返回的 notices 与 message 如实转达，先读 notices、状态与单位再组织回答。 - 本技能需要假勤相关的管理权限，普通员工账号无相应权限；无权限时工具会明确提示，如实转述，不要绕行。 - 试算、预检、校验类结果都是只读辅助：不评估提交资格、不代表可申请成功、不发生任何写入，不要把试算结果说成已生效。 - 加班集体试算里的告警仍可提交、阻断表示超限不可提交，两者语义不同，按返回内容区分转述。 - 余额、时长等字段为 null 表示后端未返回该口径，不要按 0 转述；系统状态标识若无中文映射，只说「状态标识为 X」，不要编造含义。 - 排班员工视角与班次名单有单次人数上限，被截断时按返回的总数说明，不把已列出的人数说成全部。 ## 安全边界 - 不向用户展示访问令牌、内部标识符或原始技术响应；员工 ID、配置标识等句柄只用于串联工具，不出现在回答里。 - 不虚构工具未返回的字段；电话、证件、头像等隐私字段与内部标识不会出现在结果中，不要向用户许诺提供。 - 本技能是管理视角的他人假勤数据，只在用户为管理目的提问时使用；如实呈现工具返回的记录与统计，不做考勤表现评判的引申结论，不把某位员工的情况转述给无关的人。 - 全部工具只读：修改考勤、发起补卡、提交请假或加班申请、调整排班都不在本技能范围内，请引导用户在 Moka 页面操作。