eduseed-teacher-publish
① 教师用自然语言创建挑战:补全必填项→展示发布摘要→等待人工确认→写入平台+飞书→返回挑战编号;学生身份调用会被运行时拒绝;② 适合"创建一个新挑战""把这份作业发下去""周五截止的个人作品集作业";③ 触发词:发布、发作业、新挑战、建挑战
- License 许可
- MIT
- 所属仓库
- bonc-ai/cogseed
- 最近更新
- 2026-11-13
- Stars
- ★ 19
- Forks
- 10
01 前言 Front Matter
- name
- eduseed-teacher-publish
- description
- ① 教师用自然语言创建挑战:补全必填项→展示发布摘要→等待人工确认→写入平台+飞书→返回挑战编号;学生身份调用会被运行时拒绝;② 适合"创建一个新挑战""把这份作业发下去""周五截止的个人作品集作业";③ 触发词:发布、发作业、新挑战、建挑战
02 资源文件 1
- 脚本scripts/runtime.js704.3 KB
03 SKILL.md 正文
EduSeed 教师发布|自然语言建挑战(Plugin 版,MVP US-1)
本 Skill 是 EduSeed 课程客户端(Course Plugin)的教师侧入口。运行时为
scripts/runtime.js(与其它技能同一份自包含运行时,角色由 EDUSEED_ROLE=teacher 决定)。
运行时调用方式
唯一受支持的方式:
"$COGSEED_NODE" "$COGSEED_PC_DIR/bin/run-skill.cjs" eduseed-teacher-publish runtime -- <命令> '<JSON载荷>'
run_skill 工具等价形式:{skill_id:"eduseed-teacher-publish", script:"runtime", args:["<命令>","<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)。
命令面(教师视角)
| 命令 | 作用 | 关键载荷 |
|---|---|---|
publish-challenge |
发布挑战(唯一写入命令) | {"title","deadline","deliverables","rubric","brief?","objective?","requiredDeliverables?","rubricDimensions?"} |
list-challenges / get-challenge |
查已有挑战(避免重复) | {"challengeId":...} |
get-challenge-content |
挑战正文全文(G3) | {"challengeId":...} 可选 workdir |
export-challenge-pack |
一键导出挑战完整资料包(任务卡+正文+材料) | {"challengeId":...,"workdir":"/abs/path"} |
list-challenge-materials / download-challenge-materials |
挑战材料清单/下载(G4,自动过滤 ._* 垃圾件) |
{"challengeId":...,"workdir":"/abs/path"} |
list-course-materials / download-course-materials |
课程级公共资料清单/下载(P3:system-docs/prereq/reference) | {"scope":"system-docs","workdir":"/abs/path"} |
get-dashboard |
班级统计(学生进度/提交) | — |
submit-review |
教师终审(accept/return) | {"evaluatorType":"teacher","submissionId","score","feedback","action","submissionRecordId?"} |
notify |
飞书通知(class_group/student_dm/teacher_dm) | {"target":"class_group","text":...} |
agent-send / agent-inbox / agent-contacts |
P3394 师生互通 | — |
health |
平台连接检查 | — |
发布工作流(MVP US-1:自然语言建挑战 + 人工确认)
- 解析意图 — 从教师自然语言提取:标题 / 截止时间 / 交付物 / 评分标准 / 背景 / 目标
- 查重 —
list-challenges/get-challenge确认没有同题挑战(有则提示,不重复发布) - 补全必填项 — 缺 deadline / deliverables / rubric 时逐个问教师补齐; rubric 可选用 4 套类型模板(build/explore/research/product)帮教师生成初稿
- 发布摘要人工确认(硬性) — 展示完整摘要:标题/背景/目标/截止/交付物(含通配符)/Rubric 摘要/
GitHub pointer/提交方式,然后问"确认发布吗?";只在教师明确确认后执行发布。
失败行为:
never_publish_without_user_confirm - 发布 —
publish-challenge(平台校验教师身份;学生调用返回ROLE_DENIED),返回受理编号task:task-xxx - 轮询取挑战编号 —
get-task轮询该 task(约 1-5s 完成):result.challengeId即真实挑战编号(如 ch-20260825xxxx-xxxx)- 回报教师:挑战编号 + 飞书群公告已触发说明;task 失败则回读
result.error转达驳回原因
确认卡片(GUI 模式,硬性要求)
具备 create_artifact 工具时必须使用「确认卡片」,禁止退化为纯文字确认。仅当卡片创建失败或工具不可用时才允许文字确认,且必须在回复中明确说明原因:
- 创建 artifact(title=「待确认:发布挑战」),含两个文件:
index.html:确认卡片宿主模板(附录 A,原样使用,不要增删改动)confirm-config.json:{"op":"publish-challenge","payload":{…完整写入载荷…}}
- 对话中会渲染出插件确认面板(载荷摘要 + 确认/取消按钮);
- 等待用户操作:
- 收到
{"action":"plugin-confirm","op":"publish-challenge","payload":…}→ 用该 payload 执行第 5 步publish-challenge; - 收到
{"action":"plugin-cancel",…}或用户文字取消 → 停止写入,按用户意见修改;
- 收到
- 用户未点击时不得执行写入。
附录 A:确认卡片宿主(index.html 模板)
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8" />
<title>确认卡片</title>
</head>
<body style="margin:0;background:transparent">
<script src="__cogseed/bridge.js"></script>
<script>
(function () {
'use strict';
var frame = document.createElement('iframe');
frame.style.cssText = 'width:100%;border:0;display:block;min-height:340px';
frame.setAttribute('sandbox', 'allow-scripts allow-same-origin allow-forms');
frame.setAttribute('referrerpolicy', 'no-referrer');
document.body.appendChild(frame);
function sendToChat(payload) {
if (window.cogseedArtifact && typeof window.cogseedArtifact.send === 'function') {
window.cogseedArtifact.send(payload);
return;
}
try { parent.postMessage({ __cogseedArtifact: true, type: 'submit', payload: payload }, '*'); } catch (e) {}
}
fetch('./confirm-config.json')
.then(function (r) { if (!r.ok) throw new Error('no config'); return r.json(); })
.then(function (c) {
var q = new URLSearchParams();
q.set('op', String((c && c.op) || ''));
q.set('payload', JSON.stringify((c && c.payload) || {}));
frame.src = 'cogseed-plugin://eduseed-course-client/ui/confirm.html?' + q.toString();
})
.catch(function () { frame.remove(); });
window.addEventListener('message', function (ev) {
var d = ev.data;
if (!d || typeof d !== 'object' || d.__cogseedPlugin !== true) return;
try { if (ev.source !== frame.contentWindow) return; } catch (e) { return; }
if (d.type === 'resize') {
var h = Number(d.height);
if (isFinite(h) && h > 0) frame.style.height = Math.min(Math.max(h, 120), 900) + 'px';
return;
}
if (d.type === 'confirm') {
sendToChat({ action: 'plugin-confirm', op: String(d.op || ''), payload: d.payload });
return;
}
if (d.type === 'cancel') {
sendToChat({ action: 'plugin-cancel', op: String(d.op || '') });
return;
}
});
})();
</script>
</body>
</html>```
## 缺失字段处理(不直接发布)
- 缺 deadline → 提示补充
- 缺 rubric → 提示补充(或选类型模板)
- 缺 required_deliverables → 提示补充(支持 * 通配符)
- 缺 GitHub pointer → 提示补充
## 付费授权(激活门,硬性)
- 除 help/license-check/plugin-version/health 外,**每个命令执行前运行时自动向平台做授权校验**(教师席位 teacher-seat);
- 返回 `LICENSE_REQUIRED` / `SEAT_NOT_LICENSED` 时:**立即停止**,如实告诉教师"该教师席位未授权,请联系平台管理员开通",不得绕过;
- `license-check` 命令可主动查询授权状态。
## 版本检查(skill 自动更新,硬性)
- 每次开始课程任务前,先执行 `plugin-version`:
- `update_required: true` → **立即停止**,告知必须升级(`cogseed-pkg update aix-course-elite20`,用 PLUGIN_TOKEN);
- `update_available: true` → 提示可升级,不阻塞当前任务;
- 已是最新 → 继续。
## 身份红线
- 本 Skill 只在教师 Agent(EDUSEED_ROLE=teacher + 教师 api_key)下工作;
- 学生身份调用 `publish-challenge` 会被运行时拒绝(ROLE_DENIED)——不要尝试绕过;
- AI 只生成发布草稿,最终发布决定权在教师(人工确认步骤)。
## 停止规则
metadata 缺失且教师未补充;教师未确认发布摘要;用户取消。
## 失败行为
never_publish_incomplete_metadata;never_fabricate_deadline_or_rubric;
never_publish_without_user_confirm;return_completed_and_uncompleted_parts
04 同仓库更多 Skills
sample-supply-chain
供应链样本:安装钩子 + 拼写伪装 + 源覆盖。
sample-prose-only
纯散文安全守则样本:禁止某行为的说明不等于该行为。
sample-obfuscated
混淆载荷样本:解码与执行共现。
sample-hidden-content
隐藏内容载荷样本:用于回归「不可见字符不做上下文降权」这一不变量。
sample-evasion
反规避样本:危险内容只以「不可见字符切断」与「编码后」两种形式出现。
sample-agentic
代理运行时风险样本:配置篡改 + 隐蔽指令。