grading-backend

Installation
SKILL.md

grading-backend

给 AI 培训项目后端实现打分。50 学员分成 ~12 组,按 spec-driven 方式实现本地部署的后端服务。本 skill 让 Claude(或 Qoder / Cursor / Claude Code agent)按统一 rubric 给某一组的后端打分,产出可给学员的 markdown 报告 + 可汇总 leaderboard 的 JSON。


前置依赖

  • 本地可跑:待评后端能在本机启动(npm run dev / uvicorn ... / go run ./... / ./gradlew bootRun 等),默认 http://localhost:8080(按项目 README 调整),有 health check 端点(/health / /healthz / /ping)或其他就绪信号。
  • Spec 文档位置<project>/docs/spec.md<project>/README.md<project>/spec/*。找不到则先向用户确认 spec 路径再开工,不要凭空评分。
  • Node.js 环境:Node ≥ 18,用来跑 npx ajv-cli 校验 JSON、npx autocannon 做压测。
  • curl:所有接口探针和取证命令基于 curl,macOS / Linux 自带即可。
  • 输出目录:所有证据和报告写到待评项目根目录下的 .grading/(已由 spec 约定 gitignore)。

约定的工作目录:所有 probe 脚本和 .grading/ 输出都默认在待评项目根目录下执行。即评分时:

  1. cd 到被评项目(如 cd group-workshop/group-2
  2. 用绝对路径调用 probe:bash $WORKSHOP_ROOT/skills/grading-backend/probes/probe-robustness.sh team-2 http://localhost:8080 /api/items
  3. .grading/ 会落到被评项目根下,与该项目共生
Related skills
Installs
1
First Seen
Apr 15, 2026