SuperAPI AI 工具集

kth-data

数据与分析

查看项目

更新于 10-15 20:34

技能介绍

用途:集中提供 KTH 相关事实的查询入口,避免凭记忆作答。所有内容均为查找,实际编辑交给 canvaslms、nytid 等工具。

主要能力与用法:

  1. Canvas 沙箱课程:写入类 canvaslms 命令(页面、作业、模块项、日历、测验等)应在用户自己的沙箱课程 "Sandbox dbosk"(课程 id 24725)测试,用锚定正则选择:canvaslms ... -c "^Sandbox dbosk$"。优先复用已有条目,临时产物加可识别前缀(如 canvaslms-test-DELETE-ME)并在事后删除;用 --no-cache 验证写入,因为 CLI 写入时会更新本地缓存,缓存读取可能掩盖服务端未生效;测试后恢复改动。不要对真实服务器测试扇出路径(如 create-in-all-courses),沙箱内也不行。真实课程(datintro26、tilkry 等)默认只读研究。
  2. 教室:KTH 教室目录 https://www.kth.se/places/,房间页 https://www.kth.se/places/room/<ROOM NAME> 会重定向到 /places/room/id/<uuid>,列出 Platser(座位,用于讲座/研讨容量)、Examinationsplatser(考试座位,通常少得多)、房间类型、位置与设备。可用脚本查询:~/.claude/skills/kth-data/scripts/kth_room.py V32 B1 "Ka-Sal C" | column -t -s$'\t',输出 TSV(名称、座位、考试座位、类型、楼、地址、URL),未知房间输出 not found 并返回退出码 1。房间名用课表中的短代码(V32、B1、E1、Ka-Sal C、D2、Q1);相邻编号通常同楼相邻,便于拆分大组。座位数以查询结果为准,不要沿用往年数字。
  3. 学期与周期日期:KTH 在 intranet 按学年发布 läsårsindelning(HT/VT、P1–P4、考试期、补考期)。应搜索而非信任记忆中的 URL:WebSearch KTH läsårsindelning läsåret <YYYY>-<YYYY+1> 或 site:intra.kth.se läsårsindelning <year>;索引页为 https://intra.kth.se/utbildning/schema-och-lokalbokning/lasarsindelning/perioder。随后 WebFetch 学年页读取瑞典语 YY-MM-DD 日期。约定:P1 从 "inledande veckor" 后一周的周一开始,P1/P2 为 HT,P3/P4 为 VT,每期以 Tentaperiod 结束,Omexaminationsperiod 为补考。产出中须附来源 URL,截止日期不得凭记忆。
  4. 用户课表:nytid schedule show 可查用户教学安排、教室与预订助教。示例:nytid schedule show --help;nytid schedule show;nytid schedule show datintro26 --start 2026-08-22 --end 2026-09-01 --no-todo --week。可回答何时何地、哪些教室被预订、哪些助教被预订(Booked TAs 字段,按报名顺序;--user '.*' 无效)。细节见 references/nytid.md。
  5. 课程注册、学生数、助教、Zulip:课程轮次在 nytid 注册表(tcs 为 TCS 组共享注册表,mine 为用户符号链接)。多项目课程有一个合并配置加每个项目一个子课程,各含计划学生数:nytid courses ls -r tcs | grep datintro26;nytid courses config datintro26-cdate num_students --register tcs;nytid hr users datintro26;nytid zulip datintro26 streams(send 以用户身份发帖)。轮次开始前规划教室应使用注册表的 num_students,而非 Canvas 选课人数。

适用场景:为讲座分配项目到教室(结合课表、教室座位、注册人数,尽量同楼或相邻,留余量,优先满足讲师约束,容量不足时宁可少量溢出到 Zoom);发布学生可见映射到 Canvas(canvaslms pages edit,若课程以仓库文件维护页面则改文件并推送),员工专属细节放课程 Zulip。

限制:本技能只做查询,不执行编辑;日期与容量必须实时查询并附来源;不得对真实服务器做写入测试;未提供的功能、收费与平台信息暂未提供。