NoodleStormno/sysu-cli / skills/sysu-cli-skill
sysu-cli-skill
UnverifiedSYSU Campus Services Skill (sysu-cli)
sysu-cli is the single source of truth. This skill tells the agent which command to run, how to handle its JSON output, and what safety/rate-limit rules must never be violated.
Strict Anti-High-Frequency & Rate-Limit Rules (严禁高频访问限制)
- 严禁高频访问与轮询(NO High-Frequency Polling or Burst Loops):
- 绝不允许通过
while/for循环、定时脚本、后台高频轮询或并发请求连续调用任何sysu-cli命令(包括但不限于持续监控体育场余量、定时毫秒级连发抢场、批量爬取图书馆或全校开课目录)。 - 每次用户对话回合中,针对同一资源的查询最多执行 1 次;如需分页或跟进查询,单回合内总调用次数不得超过 3 次。
- 绝不允许通过
- 体育场馆订场仅限单次按需请求(Single-Request Booking Only):
sysu-cli gym book与sysu-cli gym cancel内置跨进程冷却锁(~/.sysu-cli/rate-limit.json)。- 仅在用户明确告知目标场馆、日期、时间段后发起单次
gym book(或--waitlist候补)。如果返回场地已满、UPSTREAM_ERROR或RATE_LIMITED,必须立即停止并向用户汇报结果,严禁自动循环重试或抢场。
- 遇到限流立即熔断:一旦任何命令返回
error.code === "RATE_LIMITED"或 WAF 拦截提示,必须立即停止所有后续调用,不得重试。
Security & Privacy Rules
- Never ask for the user's NetID password, verification code, or cookie files.
- Never bypass unified authentication, Geetest slider verification, Safeline WAF, WeCom QR confirmation, or campus-network / VPN requirements.
- Run one browser login command (
auth login,gym login,usc login) at a time. - Every command outputs JSON
{ ok, command, data | error }. Parse JSON; do not scrape prose. - Treat grades, GPA, rank, student identifiers, and wallet balances as private: report only what the user asked for.
Readiness & Login Flow
- JWXT (本科教务系统
jwxt.sysu.edu.cn):- Check status:
sysu-cli auth status - If
loggedIn: false, trysysu-cli auth refreshonce; if it still returnsLOGIN_REQUIRED, runsysu-cli auth loginand ask the user to complete login in the opened browser window.
- Check status:
- Library OPAC (图书馆馆藏检索):
- No login is required.
sysu-cli library searchandsysu-cli library holdingswork directly on the campus network / VPN.
- No login is required.
- Sports Venues (
gym.sysu.edu.cn):- If any
gymcommand returnsLOGIN_REQUIRED, runsysu-cli gym loginonce and ask the user to finish CAS login in the opened browser window sosysu-clican save the Scientia Bearer JWT.
- If any
- University Service Center & Payment Hall (
usc.sysu.edu.cn/pay.sysu.edu.cn):- If any
uscorfeecommand returnsLOGIN_REQUIRED, runsysu-cli usc loginonce and wait for the user to finish login in the opened browser window.
- If any
- Online Learning Platform (
lms.sysu.edu.cnMoodle):sysu-cli lms categoriesandsysu-cli lms searchwork without login.- If
lms courses,lms deadlines,lms tasks, orlms quizreturnsLOGIN_REQUIRED, runsysu-cli lms loginonce (it will try silent CAS SSO first, or open a browser window if needed).
Command Routing
| User intent | Command |
|---|---|
| Current academic year/semester and teaching week | sysu-cli term current |
| This week's timetable / a specific week or weekday | sysu-cli course list [--term YYYY-N] [--week N] [--weekday 1..7] |
| Today's or a specific date's classes | sysu-cli course today [--date YYYY-MM-DD] |
Export timetable to .ics calendar | sysu-cli course export-ics [--term YYYY-N] [--week N | --from-week M --to-week N] [--out schedule.ics] |
| Semester grades, weighted GPA, and rank | sysu-cli grade list [--term YYYY-N] |
| Credit completion overview & score distribution | sysu-cli grade credits |
| Available exam weeks in a term | sysu-cli exam weeks [--term YYYY-N] |
| Exam schedule (all or filtered) | sysu-cli exam list [--term YYYY-N] [--type "18-19周期末考"|"10-17周结课考"|"缓补考"] [--week-id ID] |
| List campuses / teaching buildings | sysu-cli classroom campuses / sysu-cli classroom buildings [--campus 校区] |
| Find empty classrooms in a building | sysu-cli classroom empty --building 教学楼 [--campus 校区] [--date YYYY-MM-DD] [--sections 1-2] [--all] |
| CET-4 / CET-6 scores | sysu-cli cet list [--level 4|6] |
| Undergraduate Office & college notices | sysu-cli notice list [--category all|education|college] [--search 关键词] [--limit 20] |
| Graduation credit completion audit | sysu-cli completion summary / sysu-cli completion courses [--category 代码] [--search 关键词] |
| Personal training program (个人培养方案) | sysu-cli program view [--category publicRequired|...] [--search 关键词] |
| Search university-wide course offerings | sysu-cli catalog search [--term YYYY-N] [--name 课程名] [--teacher 教师] [--department 院系] [--campus 校区] |
| Student academic record & warnings | sysu-cli profile view |
| Search library books & campus call numbers | sysu-cli library search --query 关键词 [--field any|title|author|isbn|callno] [--lang zh|en] [--campus 校区] |
| Check per-copy on-shelf status & shelf location | sysu-cli library holdings --doc 书目号 [--lang zh|en] [--campus 校区] [--available] |
Authenticate with gym.sysu.edu.cn | sysu-cli gym login |
| List sports venues across campuses | sysu-cli gym venues [--campus 校区] [--search 关键词] |
| Check court & timeslot availability | sysu-cli gym slots --venue 场馆名或ID [--date YYYY-MM-DD] [--time HH:MM] [--court 场地名] [--available] |
| View sports credits, wallet & my bookings | sysu-cli gym me |
| Book a court (single request only, no loops) | sysu-cli gym book --venue 场馆名或ID --date YYYY-MM-DD --time HH:MM [--court 场地名] [--waitlist] [--cash] |
| Cancel a gym booking or waitlist entry | sysu-cli gym cancel --id 预约UUID或订单号 |
Authenticate with usc.sysu.edu.cn & pay.sysu.edu.cn | sysu-cli usc login |
| Search USC campus service items | sysu-cli usc services [--search 关键词] [--limit 20] |
| List personal USC workflow tasks | sysu-cli usc tasks [--type todo|done|complete] |
| List unpaid bills in SYSU Payment Hall | sysu-cli fee unpaid |
Authenticate with lms.sysu.edu.cn | sysu-cli lms login |
| Browse or search LMS courses | sysu-cli lms categories / sysu-cli lms search --query 关键词 |
| List my enrolled LMS courses & progress | sysu-cli lms courses [--status all|inprogress|past|future] [--search 关键词] |
| List upcoming LMS assignment & quiz DDLs | sysu-cli lms deadlines [--days 30] |
| Extract course task links / batch-open in browser | sysu-cli lms tasks --course 课程ID [--type video|quiz|assign|all] [--todo] [--open] [--limit 5] |
| Extract quiz questions & options as plain text | sysu-cli lms quiz --id 测验ID或URL [--attempt 作答ID] [--start] |
| Environment / network diagnosis | sysu-cli doctor |
| Disconnect & wipe local session | sysu-cli auth logout |
Term format is YYYY-N where YYYY is the start year of the academic year (for example, 2026-1 means the first semester of 2026–2027; 2026-2027-1 is also accepted). Omit --term to query the current term.
Error Handling (error.code)
LOGIN_REQUIRED→ run the corresponding login command (sysu-cli auth refresh/sysu-cli auth loginfor JWXT,sysu-cli gym loginfor Gym,sysu-cli usc loginfor USC/Payment Hall) and wait for the user.RATE_LIMITED→ stop immediately; do not retry or loop.BROWSER_UNAVAILABLE→ tell the user to install Chrome/Edge or runnpx playwright install chromium.BROWSER_BUSY→ anothersysu-clibrowser window is open; wait or ask the user to close it.NETWORK_ERROR→ remind the user that SYSU services require the campus network or SYSU VPN.UPSTREAM_CHANGED→ re-run once with--rawto inspect the raw payload, or usesysu-cli dev capturewith the user to inspect current endpoints.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |