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/ 输出都默认在待评项目根目录下执行。即评分时:
- cd 到被评项目(如
cd group-workshop/group-2) - 用绝对路径调用 probe:
bash $WORKSHOP_ROOT/skills/grading-backend/probes/probe-robustness.sh team-2 http://localhost:8080 /api/items .grading/会落到被评项目根下,与该项目共生
Related skills