菜单
Diagnose TMET runtime, queue, scraping, upload, and file-artifact issues. Use when investigating failing routes, stuck jobs, broken Browserless/SUAP flows, malformed CSV or JSON outputs, Docker problems, or test regressions.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Build and update TMET backend APIs in Express. Use when changing handlers in routes/*.js, file-backed business logic in models/*.js, queue-driven async jobs, scraping/upload integrations in helpers/*.js, or response contracts under /api/matches, /api/moodle, /api/suap, /api/ai, and /api/jobs.
Validate TMET API contracts and multi-step flows, especially async job polling, generated file artifacts, and extraction -> matching -> enrollment workflows. Use when verifying behavior across routes, models, helpers, queue progress, and persisted outputs in files/.
Write and maintain TMET Jest + Supertest tests. Use when changing routes, models, helpers, queue logic, file parsing, or API contracts and you need focused coverage under tests/routes, tests/models, tests/helpers, or tests/integration.
Run, debug, and validate TMET with Docker Compose. Use when bringing up the current node + chrome stack, checking logs, running tests in-container, or confirming Browserless-based scraping and upload workflows.
Operate and evolve the TMET extraction to matching to CSV to Moodle-upload pipeline. Use when changing or debugging EduPage extraction, SUAP scraping, manual course or student queues, subject matching, AI matching, student/professor extraction, generated files in files/, or end-to-end operator workflow behavior.
Implement and maintain the TMET static frontend in public/. Use when changing public/index.html, browser-native ES modules in public/js/, UI components, section controllers, or request/model adapters that drive the pipeline, matching, manual queue, and students/professors workflows.
| name | debugging-operations |
| description | Diagnose TMET runtime, queue, scraping, upload, and file-artifact issues. Use when investigating failing routes, stuck jobs, broken Browserless/SUAP flows, malformed CSV or JSON outputs, Docker problems, or test regressions. |
routes/, models/, and helpers/.helpers/queue.js and /api/jobs/:jobId.files/*.json and files/*.csv.docker compose logs -f node and the closest failing test./api/jobs/:jobId when the bug involves async work.helpers/scraper.js + config/suap-config.js for SUAP login/session issueshelpers/timetables.js for EduPage extraction issueshelpers/moodle-uploader.js for Moodle upload failureshelpers/chat-assist.js + models/AIMatch.js for AI matching failureshelpers/queue.js when jobs appear stuck, missing, or prematurely cleaned updocker compose ps
docker compose logs -f node
docker compose exec node npm test -- tests/routes/suapRoute.test.js
docker compose exec node npm test -- tests/helpers/queue.test.js