oa-attendance-query

star 0

当用户提到考勤记录、打卡记录、异常考勤、加班记录、我的考勤时触发此技能。用于查询个人在特定月份的考勤情况,包括异常记录和加班记录。

ykdoit By ykdoit schedule Updated 3/1/2026

name: oa-attendance-query description: 当用户提到考勤记录、打卡记录、异常考勤、加班记录、我的考勤时触发此技能。用于查询个人在特定月份的考勤情况,包括异常记录和加班记录。

技能:查询考勤记录

1. 业务流程

并行查询两个接口:

  • oa-abnormal-attendance:查询异常考勤记录
  • oa-overtime-work:查询加班记录

调用参数:

{
  "staffDomain": "{staff_domain}",
  "yearMonth": "{year_month}"
}

2. 槽位清单

参数 说明 必填 默认值 处理方式
year_month 查询年月 当前月份 格式:YYYY-MM

year_month 处理规则

  • 用户输入"本月"、"这个月" → 当前月份(YYYY-MM)
  • 用户输入"上个月"、"上月" → 上个月(YYYY-MM)
  • 用户输入"2026年2月" → 2026-02
  • 用户已提供 YYYY-MM 格式 → 直接使用

3. 状态机

[GATHERING] 信息收集态

任务:确定查询年月

示例处理

  • 用户说"查考勤" → 使用默认值(当前月份)
  • 用户说"查上个月的考勤" → 计算上个月
  • 用户说"查2026年1月的考勤" → 直接使用

退出条件:year_month 参数确定

[EXECUTING] 执行态

任务:并行调用两个查询接口

调用1:异常考勤

{
  "staffDomain": "zhangsan",
  "yearMonth": "2026-02"
}

调用2:加班记录

{
  "staffDomain": "zhangsan",
  "yearMonth": "2026-02"
}

成功响应模板

📊 考勤记录({year_month})

## 异常考勤(共 {abnormal_count} 条)

{if abnormal_count > 0}
| 日期 | 签到 | 签退 | 状态 |
|------|------|------|------|
| 2026-02-10 | 09:30 | 18:00 | 迟到 |
| 2026-02-12 | --:-- | --:-- | 缺卡 |
{else}
✅ 无异常考勤记录
{endif}

## 加班记录(共 {overtime_count} 条,合计 {total_hours} 小时)

{if overtime_count > 0}
| 日期 | 签到 | 签退 | 类型 | 时长 |
|------|------|------|------|------|
| 2026-02-15 | 09:00 | 21:00 | 周末加班 | 10h |
| 2026-02-14 | 18:30 | 22:00 | 工作日加班 | 3.5h |
{else}
暂无加班记录
{endif}

4. 核心约束

4.1 权限限制

  • 严格限定员工只能查询本人的考勤记录
  • 无法查看其他员工的考勤信息

4.2 数据范围

  • 异常考勤:返回指定月份所有标记为异常的记录(迟到、早退、旷工等)
  • 加班记录:返回指定月份所有标记为加班的记录

4.3 状态类型

异常考勤状态

  • 迟到
  • 早退
  • 缺卡
  • 旷工

加班类型

  • 工作日加班
  • 周末加班
  • 节日加班

5. 示例对话

示例1:查询本月考勤

用户:查一下我的考勤
Agent:📊 考勤记录(2026-02)

## 异常考勤(共 2 条)

| 日期 | 签到 | 签退 | 状态 |
|------|------|------|------|
| 2026-02-10 | 09:30 | 18:00 | 迟到 |
| 2026-02-12 | --:-- | --:-- | 缺卡 |

## 加班记录(共 2 条,合计 13.5 小时)

| 日期 | 签到 | 签退 | 类型 | 时长 |
|------|------|------|------|------|
| 2026-02-15 | 09:00 | 21:00 | 周末加班 | 10h |
| 2026-02-14 | 18:30 | 22:00 | 工作日加班 | 3.5h |

示例2:无异常考勤

用户:查上个月的考勤
Agent:📊 考勤记录(2026-01)

## 异常考勤(共 0 条)

✅ 无异常考勤记录

## 加班记录(共 1 条,合计 5 小时)

| 日期 | 签到 | 签退 | 类型 | 时长 |
|------|------|------|------|------|
| 2026-01-20 | 18:00 | 23:00 | 工作日加班 | 5h |

6. 错误处理

错误场景 处理方式
查询结果为空 友好提示"该月份暂无考勤记录"
月份格式错误 提示正确格式"YYYY-MM"
网络错误 提示稍后重试
Install via CLI
npx skills add https://github.com/ykdoit/agent-backend --skill oa-attendance-query
Repository Details
star Stars 0
call_split Forks 1
navigation Branch main
article Path SKILL.md
More from Creator