ClassFeedback/.claude/skills/教学日程查询/skill.md

name, description, type, command

name	description	type	command
教学日程查询	通过调用公司API获取指定日期的教学排课数据，生成功能完整的互动网页展示课表、学生名单和出勤情况，支持搜索、筛选、导出Excel等功能。	skill	node {{skillPath}}/index.js {{args}}

教学日程查询 Skill

功能介绍

本技能用于查询指定日期的教学排课安排，直接调用公司API获取实时数据，自动生成互动网页展示详细信息，帮助老师快速了解当日授课安排和学生出勤情况。

调用方式

# 方式1：查询单天
/教学日程查询 [日期]

# 方式2：查询时间段
/教学日程查询 [开始日期] [结束日期]

参数说明

• [日期]（可选）：要查询的单天日期，支持多种格式：
  • 标准格式：2026-04-28、2026/04/28、20260428
  • 短格式：04-28、4月28日（默认使用当前年份）
  • 如果不指定日期，默认查询当天的日程
• [开始日期] 和 [结束日期]：要查询的时间段，格式同上，系统会自动查询这两个日期之间的所有日程（包含起止日期）。

示例

/教学日程查询                          # 查询当天的教学日程
/教学日程查询 2026-04-28             # 查询2026年4月28日的教学日程
/教学日程查询 4月24日 4月26日        # 查询2026年4月24日至26日的日程
/教学日程查询 2026-04-01 2026-04-30  # 查询2026年4月整个月的教学日程
/教学日程查询 20260422 20260428      # 查询2026年第17周的教学日程

功能特性

📅 日程展示

• 按时间顺序展示当天所有课程安排
• 显示班级名称、授课时间、授课老师、校区、学生人数
• 点击课程卡片展开查看详细学生名单

🔍 搜索筛选

• 支持按班级名称搜索
• 支持按学生姓名搜索
• 支持按出勤状态筛选学生（出勤/请假/缺勤）

📊 数据导出

• 支持将当前课表导出为Excel文件
• 导出内容包含班级信息、学生名单、出勤状态、备注

📱 响应式设计

• 支持电脑、平板、手机等多种设备访问
• 界面美观易用，操作流畅

输出文件

生成的网页和数据会保存在以下目录：

.claude/output/teaching-schedule/日期范围/
├── schedule.html    # 互动网页文件
└── schedule.json    # 原始API数据文件

例如：查询4月24日至26日，输出目录为 .claude/output/teaching-schedule/2026-04-24_2026-04-26/

使用说明

1. 调用命令后，系统会自动调用公司API获取实时排课数据
2. 数据获取成功后会生成互动网页
3. 点击返回的链接即可打开网页查看详细信息
4. 在网页中可以进行搜索、筛选、导出等操作

配置说明

API配置信息保存在项目根目录的 .env 文件中：

• API_BASE_URL：公司API地址
• AUTHORIZATION：API认证令牌
• EMPLOYEE_NAME：默认查询的老师姓名