ClassFeedback/.claude/skills/出勤记录

name, description

name	description
出勤记录	查询和管理学生出勤情况，支持按学生姓名、班级、时间范围查询

📊 出勤记录查询系统

功能说明

本技能用于查询学生出勤情况，生成出勤报表。

🎯 核心逻辑

出勤记录文件位置

.claude/memory/class/[班级]/[学生姓名]/feedback/出勤登记-2026春季.md

出勤记录状态说明

• ✅ 出勤：学生正常上课
• ⏸ 请假：学生请假
• ❌ 未上课：学生未上课

📋 使用方法

方式1：查询某个学生

/出勤记录 陈嘉博

输出：陈嘉博本学期的所有出勤记录和出勤率统计

方式2：查询某个班级

/出勤记录 周六晚上1900AI03班

输出：该班级所有学生的出勤汇总表

方式3：查询指定月份

/出勤记录 陈嘉博 4月

输出：该学生4月份的出勤情况

方式4：查询全部

/出勤记录

输出：所有班级所有学生的出勤汇总

方式5：查询班级最近N节课出勤率 ⭐新增

/出勤记录 周六晚上1900AI03班 前3节课

输出：该班级从本周起往回数3节课的出勤情况

• 例如：本周是第6课，则统计第4、5、6课的出勤情况

/出勤记录 周六晚上1900AI03班 前4节课

输出：该班级从本周起往回数4节课的出勤情况

• 例如：本周是第6课，则统计第3、4、5、6课的出勤情况

📊 输出格式

个人出勤记录

👤 学生：陈嘉博
🏫 班级：周六晚上1900AI03班
📅 学期：2026春季

| 日期 | 课程 | 课次 | 状态 | 备注 |
|------|------|------|------|------|
| 2026-04-06 | AI大作家下 | 第5课 | ✅ 出勤 | 已生成课评 |
| 2026-03-30 | AI大作家上 | 第4课 | ❌ 缺勤 | 病假 |
| 2026-03-23 | AI训练师 | 第3课 | ✅ 出勤 | 已生成课评 |

📊 统计：
- 应出勤：5次
- 实际出勤：4次
- 缺勤：1次
- 出勤率：80%

班级汇总表

📋 班级：周六晚上1900AI03班
📅 学期：2026春季

| 学生姓名 | 应出勤 | 实际出勤 | 缺勤 | 出勤率 |
|----------|--------|----------|------|--------|
| 陈嘉博   | 5      | 4        | 1    | 80%    |
| 谭俊研   | 5      | 5        | 0    | 100%   |
| 李承泽   | 5      | 5        | 0    | 100%   |
| 王子墨   | 5      | 4        | 1    | 80%    |

📊 班级总出勤率：90%

班级最近N节课出勤率表 ⭐新增

📋 班级：周六晚上1900AI03班
📊 统计范围：最近3节课（第4课-第6课）

| 学生姓名 | 应出勤 | 实际出勤 | 缺勤 | 出勤率 | 缺勤课次 |
|----------|--------|----------|------|--------|----------|
| 陈嘉博   | 3      | 3        | 0    | 100%   | -        |
| 谭俊研   | 3      | 2        | 1    | 67%    | 第5课    |
| 李承泽   | 3      | 3        | 0    | 100%   | -        |
| 王子墨   | 3      | 3        | 0    | 100%   | -        |
| 黄彦棋   | 3      | 1        | 2    | 33%    | 第4,6课  |

📊 班级最近3节课平均出勤率：75% (12/16人次)
⚠️ 需关注学生：谭俊研、黄彦棋

🔧 实现步骤

当用户调用 /出勤记录 时：

1. 解析参数

   • 读取用户输入的学生姓名、班级、时间范围
   • 如果参数包含"前N节课"（如"前3节课"、"前4节课"），标记为最近N节课查询模式
   • 确定查询范围

2. 定位文件夹

   • 根据班级名称定位到 .claude/memory/class/[班级]/
   • 如果指定学生，再定位到具体学生文件夹

3. 读取出勤文件

   • 查找每个学生文件夹下的 出勤登记-2026春季.md
   • 如果文件不存在，显示"暂无出勤记录"

4. 解析表格数据

   • 提取表格中的每一行数据
   • 如果有日期筛选条件，筛选指定月份的记录
   • 如果是最近N节课查询：
     • 先从所有记录中找到最大课次（当前课次）
     • 计算查询范围：当前课次-(N-1) 到 当前课次
     • 只保留该范围内的记录（如当前第6课，"前3节课"保留第4、5、6课）
     • 记录每位学生的缺勤课次

5. 生成报表

   • 统计出勤、缺勤次数
   • 计算出勤率
   • 最近N节课查询特有统计：
     • 计算班级平均出勤率
     • 列出需关注学生（出勤率低于100%的学生）
     • 显示每位学生的具体缺勤课次
   • 按格式输出报表

6. 返回结果

   • 显示清晰易读的出勤报表

💡 技巧提示

快速筛选

• 可以用 "4月"、"3月" 等月份名称快速筛选
• 可以用 "2026-04-06" 这样的具体日期查询单次出勤
• 可以用 "前3节课"、"前4节课" 查询班级前N节课出勤情况

最近N节课查询使用场景

• 阶段性检查：了解学生最近3-4节课的出勤趋势
• 重点关注：找出近期缺勤或出勤率低的学生的具体缺勤课次
• 动态跟踪：每周更新，掌握最新出勤情况

示例：

• 本周是第6课，前3节课 查询的是第4、5、6课
• 本周是第6课，前4节课 查询的是第3、4、5、6课

异常处理

• 如果学生文件夹不存在，提示"该学生不在系统中"
• 如果出勤文件不存在，提示"该学生暂无出勤记录"
• 如果表格格式错误，提示"出勤记录文件格式有误"

扩展功能

未来可以添加：

• 导出Excel功能
• 月度出勤对比
• 缺勤原因统计
• 出勤趋势图