12个技能全解析:StudyMate里谁负责课件、出题、评估与档案?

原创2026-10-19 23:40:311,908 阅读

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 实验课验收协议:以可运行证据为准

StudyMate 系统架构图:总控、12个技能与学习工作区的协作关系

一个有意思的细节:5 个角色技能都标了 disable-model-invocation: true 和 user-invocable: false——你不能直接召唤它们,模型也不会擅自加载。它们只会被总控用"全新上下文 + 先读自己的规格文件"的方式派出去干活,像临时组建的项目组,干完即散。

大脑:learning-system 总控

打开 preset/skills/learning-system/SKILL.md,这是整个系统的调度中枢。它有三条铁律:

  • 与用户交互只有它:盘问、确认、提问都由它亲自做,子 agent 没有"用户通道";
  • 只派五类活:收集资料、采图、拟大纲、写课件、出题与验收——需要外部检索、大量生成或独立验证的才派,其余自己干;
  • 每轮以"下一步"收尾:报告完进展必须告诉你"谁做什么——怎么触发",不让你干等。

会话开场它只调一次工作区摘要工具,就能恢复出每门课的当前节点、三档进度和共享记忆;然后按"学习循环"推进一个节点:讲解 → 出题 → 交接门禁 → 搬入校验 → 交给你在阅读端学习 → 验收 → 更新档案。

StudyMate 对话示例:总控盘问学习目标并推进建课流程

还没想好学什么: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 课程大纲路线图:知识点按依赖分层排开、按状态着色

大纲必须通过 studymate_validate_curriculum 校验(环检测、引用完整性、实验课必须有前置)才算交付。

3. image-scout · 采图

课件里的现成图都归它。它沿资源清单点名的站点只搬网页里现成的位图:宽于 400px、小于 500KB、与科目相关,logo 和水印一律过滤;按 <主题>-<子主题>-<要点>-<来源缩写>-<NN> 的可检索规则命名,落进科目图片库,并维护一份索引表(来源 URL、许可、尺寸、抓取日期)——这是课件挑图的唯一检索入口。抓不到图不算失败,记进 Gaps 即可,图片库为空不阻塞开课。

4. learning-coach · 讲解

这是"写课件"的人。它的工序很有章法:先把本节点的来源原文读进来再落笔;写前做"首现自检"(每个专名第一次出现时读者必须知道它是什么);整份一次写出去,之后只定点修改不许整篇重写;放题处只留题目位置(锚点),自己不写一道题——题由谁出?下一位。

StudyMate 课件页面示例:教材式讲解、配图与题目位置

它交出的"课件内容文件"里只有内容格式;页面结构、上下节课指针、公式排版全部由阅读端渲染时产出。

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 就是最权威的一手资料。

登录后查看全文
Study-Mate