Attendance Check

SKILL.md

---
name: attendance-check
description: 查询基础业务开发部的考勤数据。当用户要求查看基础业务开发部（或旗下的支付清算组、支付前端组、支付应用组、APP组、商户运营组、增值业务组、业务管理组）的考勤情况、平均工时、缺卡记录时使用。提供三个报告：各组平均工时排行、月平均工时低于 9.5h 的员工列表、当月缺卡记录明细。
---

# 基础业务开发部考勤查询

通过飞书考勤 API 查询基础业务开发部各团队的考勤数据，生成三种报告：
1. 各组平均工时排行
2. 月平均工时低于 9.5h 的员工名单
3. 当月缺卡记录明细（含日期和类型）

## 使用方法

### 查当月考勤

```bash
python3 scripts/query_attendance.py
```

### 查指定月份

```bash
python3 scripts/query_attendance.py 202606   # 查2026年6月
python3 scripts/query_attendance.py 202605   # 查2026年5月
```

### 报告说明

**报告一：各组平均工时排行**
- 按平均工时从高到低排序
- 平均工时 = 各组成员总实际工时 ÷ 总工作日数
- 排除周末节假日和全天请假
- 半天请假工时计入总工时，但不计为工作日
- 列出团队名称、人数、平均工时、总工时、总工作日

**报告二：月平均工时低于 9.5h 的员工**
- 平均工时 = 总实际工时 ÷ 工作日天数
- 只计应出勤 > 0 的工作日（排除周末和节假日）
- **请假处理**：全天/半天请假天数都计入请假统计
  - 全天请假（1天）：实际工时为0，完全排除
  - 半天请假（0.5天）：实际出勤工时计入总工时，但该天不计入工作日数
- 列出姓名、所属团队、平均工时、总工时、工作天数、请假天数

**报告三：当月缺卡情况**
- 识别上班缺卡和下班缺卡
- 排除查询当天（当天数据未完整，避免误报）
- 列出姓名、团队、日期、缺卡类型
- 末尾按人员汇总缺卡次数
- 输出完整，不省略任何记录

## 注意事项

- 脚本硬编码了基础业务开发部的员工工号列表，员工变动时需要更新 `EMPLOYEE_IDS` 数组
- 当前覆盖的团队：支付清算组、支付前端组、支付应用组、APP组、商户运营组、增值业务组、业务管理组
- 如需查询其他部门，需修改 `VALID_DEPARTMENTS` 和 `EMPLOYEE_IDS`
- API 限制：单次最多查 200 人，30 天时间窗口
- 缺卡报告自动排除查询当天，避免因当天未下班导致的误报