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
- 脚本scripts/runtime.js704.3 KB
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 |
评审工作流
- 确认分配 — 同伴评审:平台校验分配关系(未被分配 → 403,不要尝试评任意提交)
- 读真实代码(强制) — clone 到本地 worktree,用文件工具查看源码/README/提交历史; 不允许只读项目摘要就打分
- 按 rubric 打分 — 逐维度给分,汇总 0-100
- 结构化反馈 — 每个维度一句话评语 + 具体到代码位置/函数名
- 提交评审 —
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
sample-supply-chain
供应链样本:安装钩子 + 拼写伪装 + 源覆盖。
sample-prose-only
纯散文安全守则样本:禁止某行为的说明不等于该行为。
sample-obfuscated
混淆载荷样本:解码与执行共现。
sample-hidden-content
隐藏内容载荷样本:用于回归「不可见字符不做上下文降权」这一不变量。
sample-evasion
反规避样本:危险内容只以「不可见字符切断」与「编码后」两种形式出现。
sample-agentic
代理运行时风险样本:配置篡改 + 隐蔽指令。