AGENT SKILL

eduseed-student-review

① 按 rubric 维度评审他人提交(同伴评审/教师终审),评审前强制读真实代码并做评语质量预检;② 适合"帮我评审这个提交""终审张三的 C03""看看待评审的作业";③ 触发词:评审、终审、打分、反馈、待评审

License 许可
MIT
所属仓库
bonc-ai/cogseed
最近更新
2026-11-13
Stars
★ 19
Forks
10

01 前言 Front Matter

name
eduseed-student-review
description
① 按 rubric 维度评审他人提交(同伴评审/教师终审),评审前强制读真实代码并做评语质量预检;② 适合"帮我评审这个提交""终审张三的 C03""看看待评审的作业";③ 触发词:评审、终审、打分、反馈、待评审

02 资源文件 1

03 SKILL.md 正文

EduSeed 评审|同伴评审与教师终审(Plugin 版)

本 Skill 是 EduSeed 课程客户端(Course Plugin)的评审技能,与 eduseed-student-submit 共用运行时 scripts/runtime.js。评审者读真实代码、按 rubric 反馈,结果回传平台。

运行时调用方式

唯一受支持的方式:

"$COGSEED_NODE" "$COGSEED_PC_DIR/bin/run-skill.cjs" eduseed-student-review runtime -- <命令> '<JSON载荷>'

⚠️ 不要用 node scripts/runtime.js … 之类的方式直接跑脚本——run-skill.cjs 是宿主注入运行时凭证的唯一入口,绕过它就拿不到凭证,需要鉴权的命令会全部 AUTH_FAILED。

凭证由宿主注入(不要自行查找)

EDUSEED_*(SERVER_URL / API_KEY / STUDENT_ID / ROLE)由 CogSeed 在技能运行的那一刻注入技能进程,随本次运行结束即收回。因此:

  • bash 里 printenv 看不到 EDUSEED_* 是正常的,不代表凭证缺失;
  • 不要用环境变量判断凭证是否存在,不要全盘 find / grep 搜凭证文件,不要用桌面或下载目录里的历史 *-config-*.json(可能是别的学号的旧配置);
  • 需要鉴权的命令只用上面那条命令即可,凭证会自动到位;health 是免鉴权端点,通过不代表凭证有效;
  • 报 AUTH_FAILED 时,正确处置是引导学生到平台 /companion 重新生成 API Key;绝不要关闭授权校验(如 EDUSEED_REQUIRE_LICENSE=0)。

本技能常用命令

命令 评审中的用途
get-dashboard 看待评审队列/统计
get-evaluation 确认目标提交的 AI 初评({"submissionId":...})
get-challenge 拿 rubric_dimensions(逐维度打分依据)
submit-review 提交评审(唯一写入命令):{"evaluatorType":"peer","submissionId","score","feedback"} 或教师 `{"evaluatorType":"teacher",...,"action":"accept

评审工作流

  1. 确认分配 — 同伴评审:平台校验分配关系(未被分配 → 403,不要尝试评任意提交)
  2. 读真实代码(强制) — clone 到本地 worktree,用文件工具查看源码/README/提交历史; 不允许只读项目摘要就打分
  3. 按 rubric 打分 — 逐维度给分,汇总 0-100
  4. 结构化反馈 — 每个维度一句话评语 + 具体到代码位置/函数名
  5. 提交评审 — submit-review:
    • 同伴:evaluatorType:"peer"(平台校验分配关系)
    • 教师:evaluatorType:"teacher" + action(accept→COMPLETED;return→RETURNED_FOR_REVISION),走消息总线

评语质量预检(提交前自检)

  • ✅ ≥50 字,具体到代码("src/main.py 硬编码 API key",不是"挺好的")
  • ✅ 有建设性建议("建议改成环境变量")
  • ❌ 全维度满分(疑似橡皮图章,需说明理由)
  • ❌ 复制粘贴模板评语

教师终审附加规则(教师反馈最终优先级)

  • AI 初评是参考,教师裁定是权威
  • 分差 >15 分时平台标注"高偏差请复核"——教师应说明调整理由
  • 教师终审会由运行时自动记录 KSTAR episode(读代码/采纳建议/ΔR 视角)

停止规则

未被分配评审(平台 403);代码无法访问(报告而非编造);用户取消。

失败行为

never_review_without_reading_code;never_score_without_rubric; never_fabricate_code_references;return_completed_and_uncompleted_parts

版本检查(skill 自动更新)

开始评审前执行 plugin-version:update_required 为 true 时先升级插件再继续;update_available 提示可升级。

04 同仓库更多 Skills