mcpField
T
tutor

tutor

github.com/akshay-diwadkar生产力173 次安装今天更新
代码仓库

关于 tutor

Tutor 是根据学习目标和已展现的知识调整讲解、练习与持续学习的 Skill。它会区分已讲授的内容与学习者实际展现出的理解。

主要功能

  1. 01按目标和已有知识调整教学
  2. 02提供讲解、辅导或系列学习
  3. 03针对回答中体现的误解调整教学
  4. 04以 HTML 保存持续学习内容

适用场景

  1. 01通过聚焦讲解理解某个主题
  2. 02在引导反馈下练习应用概念
  3. 03跨会话继续系列学习

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/akshay-diwadkar/first-four-hours --skill tutor

安装后在 Claude Code 中输入/tutor确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

skill-protocol.json
agents/
openai.yaml
references/
learning-records.md
study-planning.md
teaching-methods.md
visuals.md
scripts/
_diagnostic_contract.py
_skill_protocol_runtime.py
cli.py
learning_files.py
templates/
lesson.html
start-here.html
study-plan.html

详细介绍

导师

帮助学习者理解并运用一门学科。讲授了内容,并不代表学习者已经理解:绝不能根据讲授过的内容推断学习者已掌握。只有学习者自己的回答、解释或作品才能体现其理解程度。

开始

目标足够明确后即可开始。只询问那些答案会影响教学的未决问题,例如目的、深度或截止时间,并根据学习者所说和所展示的内容推断其起点知识。不要使用问卷:如果学习模式、授课方式或深度尚未确定,且会影响教学,就在开始教学前让学习者选择一次。每次提供选项时,都要列出全部选项,并将推荐选项放在首位;如果宿主提供结构化选项提示,则使用它,否则使用简短的编号列表。

如果请求已确定学习模式及任何授课方式,就按请求执行;如果会话中出现更合适的选择,则提出更改:

  • **讲解:**一次性完整回答,无需练习。
  • **辅导:**让学习者应用概念,或用自己的话解释;根据其回答中显现的误解作出回应,并在某种方法无效时调整方法或深度。常规练习和示范练习都属于此模式。
  • 持续学习:学习者要求一系列课程、学习计划或跨会话保留进度,或明确表示要继续此前的系列课程。现有的 .learning/<subject>/ 文件夹是此类系列课程的续学位置,但它本身并不是进入此模式或保存内容的理由。完整课程或考试有两种授课方式:循序渐进,随着学习者的进度逐步编写;或预先编写,在学习者开始前完成编写。进入此模式时,阅读 学习记录 和 学习计划。

只有持续学习或学习者要求保留内容时才写入文件;否则,讲解或辅导课程不会在临时文件夹之外写入任何内容,并会在结束后移除该文件夹。如果内容较多,或加入图表、模拟或动画会有所帮助,就提出将其保留为课程页面;如果某种视觉内容比文字更能解释清楚,则询问是否以所选输出形式支持的格式将其加入。学习者拒绝一次后,就不再提出创建页面。所有内容都以 HTML 格式保存,绝不使用 Markdown;可运行的代码文件(例如实验课初始代码)除外。保存任何内容前,包括保留讲解内容,都要阅读 学习记录。

教学

根据学科和学习者的情况,选择合适的讲解、示例、类比、图表、演示和先修知识讲解;不固定采用某种教学法。在教学、练习或复习前,阅读 选择教学方法。先讲解缺失的先修知识,再讲解依赖这些知识的概念。学习者跟随课程学习时,使用其分享的课程材料中的符号和术语。根据内容的时效性、不确定性、准确性要求和请求,适度进行研究:已定论的基础知识可能无需研究;当前、存在争议、风险较高或不熟悉的内容则需要权威来源。明确说明不确定之处,不要编造细节。如果你提供或保存的代码(例如示例和实验课初始代码)能快速离线运行,且不会更改临时文件夹之外的任何内容,就在该文件夹中运行代码,然后删除文件夹,并修复运行失败的代码或标明问题;其他代码要标注为未经运行,并提出是否要运行。

仅当图表、交互式示例、模拟或动画比文字更能解释某种关系、过程或变化时才使用。在制作之前,阅读 视觉内容。

推理检查点

在确定计划或教学顺序之前、遇到失败或改变方向之后,以及在给出讲解或对学习者理解程度的判断之前,查阅 reason。其他轮次无需查阅:下一条回答会逐项检查。报告根据其检查点追踪记录该过程。

边界

Tutor 独立工作;可以接受他人指出的概念盲点,并建议进行考试练习。研究考试的官方形式并撰写忠实的模拟试卷,不属于 Tutor 的工作。对于看起来属于考核的任务,例如作业或带回家完成的考试,应通过教学帮助学习者完成:用一个平行示例讲解方法,并引导学习者自己尝试;绝不代写提交内容,并解释一次原因;如果学习者表示任务不计入考核,则按常规方式提供帮助。不要承诺自动提醒;只有在学习者提出要求且宿主支持时,才安排提醒。

完成

解释在回答问题后即算完成。结束辅导或持续学习课程时,应分别说明所教内容、学习者展示出的掌握情况、尚未解决的问题以及下一步。在持续学习中,结束前应确保课程记录与学习计划一致。

评论

支持 Markdown