12个技能全解析:StudyMate里谁负责课件、出题、评估与档案?
12个技能全解析:StudyMate里谁负责课件、出题、评估与档案?
StudyMate 是你的 AI 学习搭档:它帮你定路线、讲知识、做项目,学透一门科目。这套能力背后,是 preset/skills/ 目录下的 12 个技能(Skill) 在分工协作——1 个"大脑"负责调度,5 个"角色"分别干资料收集、课程设计、采图、写课件、出题与评估,其余几份是它们共同遵守的规范与协议。这篇文章带你逐个认识它们,看懂一门课从"我想学"到"验收通过"是怎么被生产出来的。
分工地图:12个技能一览
先给一张总览表,后文按类别展开:
| 类别 | 技能 | 一句话职责 |
|---|---|---|
| 🧠 总控 | learning-system |
学习流程的主教练,唯一和你对话的人 |
| 🗂️ 总控协议 | record-keeping |
档案管家:进度、误解、学习记录、共享记忆 |
| 🧭 总控协议 | learning-discovery |
你还没想好学什么时,帮你探索方向 |
| 💬 答疑协议 | local-qa |
阅读端选中一段话提问时的就地答疑 |
| 🔍 角色 | resource-scout |
找权威教材与官方文档,产出资源清单 |
| 🗺️ 角色 | curriculum-designer |
设计课程大纲(知识点路线图)与实验课 |
| 🖼️ 角色 | image-scout |
抓取网页现成图片,建好图片库与索引 |
| ✍️ 角色 | learning-coach |
把一个节点写成一节课件(讲解+配图) |
| 📝 角色 | practice-evaluator |
全系统的题都由它出,实验课验收也由它做 |
| 📏 共享规范 | lesson-design |
课件内容怎么写才像"经典教材" |
| 📏 共享规范 | layered-practice |
出题规范:四层深度、四种题型 |
| 📏 共享规范 | evidence-check |
实验课验收协议:以可运行证据为准 |
一个有意思的细节:5 个角色技能都标了 disable-model-invocation: true 和 user-invocable: false——你不能直接召唤它们,模型也不会擅自加载。它们只会被总控用"全新上下文 + 先读自己的规格文件"的方式派出去干活,像临时组建的项目组,干完即散。
大脑:learning-system 总控
打开 preset/skills/learning-system/SKILL.md,这是整个系统的调度中枢。它有三条铁律:
- 与用户交互只有它:盘问、确认、提问都由它亲自做,子 agent 没有"用户通道";
- 只派五类活:收集资料、采图、拟大纲、写课件、出题与验收——需要外部检索、大量生成或独立验证的才派,其余自己干;
- 每轮以"下一步"收尾:报告完进展必须告诉你"谁做什么——怎么触发",不让你干等。
会话开场它只调一次工作区摘要工具,就能恢复出每门课的当前节点、三档进度和共享记忆;然后按"学习循环"推进一个节点:讲解 → 出题 → 交接门禁 → 搬入校验 → 交给你在阅读端学习 → 验收 → 更新档案。
还没想好学什么:learning-discovery 方向探索
大多数 AI 学习工具默认"你已经知道要学什么",但 StudyMate 给了一个例外入口。当你在会话里说**「我不知道学什么,帮我选方向」**,总控会加载 learning-discovery 亲自执行探索协议:
- 一次只问一个实质问题,通常五问后给阶段建议,最多八问必须停;
- 围绕五个关键项:想解决什么问题、什么活动更吸引你、已有基础、可投入时间、偏好怎么学;
- 给出 2~3 个可比较的候选方向(每个含"具体成果 + 路径 + 取舍"),选择权始终在你;
- 确认建课前不创建任何科目、不写记忆——探索可以完整退出,零副作用。
选定方向后,它会复用已答内容只补缺项,交回正常建课流程,不让你重填一遍。
五个工作角色:从资料到课件的生产线
1. resource-scout · 资料收集
新科目开课的第一站。它只收高可信来源——权威教材与官方文档,低质博客和 AI 生成内容一律不进清单。产出是一份资源清单(延伸阅读 + 易变内容的官方核对来源 + Gaps 缺口记录),还会把你提供的本地教材转成 Markdown 放进 reference/,让课件"对着原文写"。详见 preset/skills/resource-scout/SKILL.md。
2. curriculum-designer · 课程设计
它把科目目标画成一张 DAG(有向无环图)课程大纲:知识点按前置依赖排成路线图,每个节点 40 分钟能完成,标题 ≤16 字、目标一句话可观察。三个关键设计:
- 三种课型:
概念(只讲)、实操(带小 lab)、实验(里程碑验收课); - 项目线索前置:3~5 个实验课节点插在大纲中间而不是结尾,配套项目从早期就作为素材逐课埋线;
- 绪论不许吓人:第一个节点要用具体现象或案例开场,而不是"学科定义 + 发展史"。
大纲必须通过 studymate_validate_curriculum 校验(环检测、引用完整性、实验课必须有前置)才算交付。
3. image-scout · 采图
课件里的现成图都归它。它沿资源清单点名的站点只搬网页里现成的位图:宽于 400px、小于 500KB、与科目相关,logo 和水印一律过滤;按 <主题>-<子主题>-<要点>-<来源缩写>-<NN> 的可检索规则命名,落进科目图片库,并维护一份索引表(来源 URL、许可、尺寸、抓取日期)——这是课件挑图的唯一检索入口。抓不到图不算失败,记进 Gaps 即可,图片库为空不阻塞开课。
4. learning-coach · 讲解
这是"写课件"的人。它的工序很有章法:先把本节点的来源原文读进来再落笔;写前做"首现自检"(每个专名第一次出现时读者必须知道它是什么);整份一次写出去,之后只定点修改不许整篇重写;放题处只留题目位置(锚点),自己不写一道题——题由谁出?下一位。
它交出的"课件内容文件"里只有内容格式;页面结构、上下节课指针、公式排版全部由阅读端渲染时产出。
5. practice-evaluator · 出题与评估
全系统的题都由它出:题面、答案、判分要点、lab 任务与参考解都是它的产出,规范见 layered-practice。它有两个出场时机:
- 时机一 · 出题(课件产出后、你开读前):按锚点逐处出题,实操课还要从 templates/lab/ 骨架起产出整套 lab(留白任务、断言、
check.sh判分入口、答案目录);实验课则出"实验说明页 + 实操任务"; - 时机二 · 验收(仅实验课):按
evidence-check协议对交付物做验收,结论指向具体证据。
它既是出题人又是验收人,这条"防线"靠规范保证:"题是我出的"和"学生说懂了"都不足以判过。
三份"rulebook":角色共用的规范
这三份规范没有角色身份,被讲解、出题角色加载后共同遵守:
📏 lesson-design(课件设计规范)——课件内核的唯一约束来源:教材式行文风格(didactic exposition)、术语先讲由来讲定义、不把没学过的东西塞进当前课、比喻和"肯定-否定"句式的克制使用。它管内容写法,不管版式,更不管题。
📏 layered-practice(题目唯一规范)——定义了题目的深度与题型:
| 四层深度 | 含义 | 通过的标志 |
|---|---|---|
| 读懂 | 能解释为什么 | 说清因果与前提 |
| 改对 | 改一处先预测再验证 | 预测与实测一致 |
| 查错 | 定位真实 bug 根因 | 根因 + 修复 + 预防 |
| 造出 | 从零做出可运行的东西 | 交付物跑通 + 讲清取舍 |
对应四种题型:客观题(页内自动判)、预测验证、开放题(学生按判分要点自评)、交付物(可运行证据核验)。题量按"作答总时长 ≤10 分钟"估——考理解与权衡,不考机械背诵。
📏 evidence-check(实验课验收协议)——只有 kind: 实验 的节点走它。证据按可信度排序:运行结果 > 学生自写测试 > 解释能力 > 口头确认;而自评、同日重试、关键词标签、仅浏览过这四样明确不算独立证据。分母是全部必需核心点,缺一条就不通过——"没有要求"不等于"都满足"。
档案管家:record-keeping
preset/skills/record-keeping/SKILL.md 定义了学习状态怎么读写,由总控亲自执行。核心概念:
- 三档进度(学习中/已学完/未开始)只写「学习进度」一份,运行期不回头改大纲里的初始状态;
- 误解库:每条必须有证据(提问原文、作答引用或验收结论),被纠正后标
superseded不删除; - 学习记录:只有可观察的证据(正确用出概念、主动说明已知、误解被纠正)才记一条;
- 共享记忆 / 科目记忆:前者记跨科目成立的画像与做法(
MEMORY.yaml),后者记单科事实——这两份是全系统角色可直接追加的文件,谁干活谁在收尾时补一行,下一门课不用重新自我介绍。
所有学习数据落在独立的学习工作区(默认 ~/StudyMate),文件一变阅读端自己就更新。
就地答疑:local-qa
在读课件时选中一段看不懂的文本或代码提问,阅读端的问答面板会就地打开一段答疑会话——它是宿主的一条真会话,不经过总控、不背整个上下文(只带课件、选中片段、共享记忆三样东西)。规则很简单:先给答案再给一句为什么,只给思路与最小示例,答完停在原地让你接着读;问题大到超出片段范围,它会明说"值得单独讲",引导你回到会话里找总控安排。
小结:一门课是怎么被"生产"出来的
把这 12 个技能串起来,就是完整的学习流水线:
你说"我想学 C++" → 总控盘问目标与基础 → 并行派出采资料 + 采图 + 拟大纲 → 讲解写课件、出题按锚点补题 → 你在阅读端学习、作答 → 实验课验收 → 总控按证据更新档案与进度 → 进入下一节点。
分工的精髓是"一份产物只经过它作者的手":讲解不写题、出题人不写课件、验收结论不改题库——每份文件的归属在 docs/规范/文件归属.md 里都有唯一出处,角色交接走 docs/规范/Agent交接协议.md 定义的暂存与门禁,题目字段契约以 schemas/question.schema.json 为准。想深入某个角色的完整规格,直接打开 preset/skills/ 下对应的 SKILL.md 就是最权威的一手资料。



