SuperAPI AI 工具集

teach

通用与其它

查看项目

更新于 10-15 10:24

技能介绍

用途

teach 用于在某个工作区内教用户一项新技能或概念。它假设用户希望跨多次会话持续学习同一主题,因此把当前目录(运行 /teach 时的目录)视为教学工作区,并用多个文件记录学习状态。

工作区结构

主要包括:MISSION.md 记录用户对该主题感兴趣的原因,用于锚定所有教学;./reference/.html 存放参考材料;RESOURCES.md 列出可探索的优质资源;./learning-records/.md 记录用户已学内容与关键洞察;./lessons/.html 是主要教学单元;./assets/ 是可复用组件;NOTES.md 用于记录用户偏好与工作笔记。

教学理念

teach 把学习分为三类:知识来自高质量、高可信资源;技能通过基于知识设计的互动课程获得;智慧来自与其他学习者和实践者的交流。在 RESOURCES.md 尚未充分填充前,重点应是寻找高质量资源,且不应依赖模型自身的参数化知识。不同主题可能侧重知识或技能,例如理论物理更偏知识,瑜伽更偏技能。

流畅度与存储强度

teach 区分流畅度(即时提取)与存储强度(长期保持)。流畅度可能带来虚假的掌握感,真正目标应是长期保持。课程通过合意困难来增强长期记忆,例如提取练习、间隔和交错练习(技能练习)。

课程

课程是主要产出,每个课程是一个自包含 HTML 文件,保存在 ./lessons/,命名为 0001-<dash-case-name>.html,序号递增。课程应美观、排版清晰,便于日后复习;应简短、可快速完成,并给用户一个可积累的具体收获;应与使命直接相关并处于最近发展区。若可行,可通过 CLI 命令打开课程文件。课程应通过 HTML 锚点链接其他课程和参考文档,推荐一个最优质的主要来源,并提醒用户向作为教师的 agent 提问。

资产

课程由可复用组件构建,存放在 ./assets/,包括样式表、测验组件、模拟器、图表辅助工具等。复用是默认做法:编写课程前先阅读 ./assets/ 并基于已有组件构建;需要新的可复用内容时,将其写为组件并链接。共享样式表是每个工作区应首先建立的组件。

使命

每节课都应与使命相连。如果用户不清楚使命或 MISSION.md 未填充,首要任务是询问用户为何想学该主题。使命可能随用户技能和知识发展而变化,这属正常,但需更新 MISSION.md 并添加学习记录,且更改前应与用户确认。

最近发展区

每节课应让用户感到被挑战得“刚刚好”。如果用户未指定具体学习内容,可通过阅读学习记录、根据使命判断合适内容,来选择最相关且处于最近发展区的内容。

知识与技能

课程应围绕用户将学习的技能设计,知识只包含获得该技能所需的部分。先教知识,再通过互动反馈循环练习技能。知识应首先来自可信资源,并用 RESOURCES.md 记录;课程应包含引用外链以增强可信度。获取知识时,难度是敌人;获取技能时,难度是工具,通过费力提取建立存储强度。技能可通过互动测验、轻量浏览器任务或引导用户完成现实步骤的课程来教,且应有尽可能紧凑的反馈循环,理想情况是即时且自动。测验中每个答案的词数应完全相同,正确项位置应变化,避免格式或顺序泄露答案。

智慧

智慧来自真实世界互动。当用户的问题需要智慧时,默认应尝试回答,但最终引导到社区。社区可以是论坛、subreddit、线下课程或本地兴趣小组;应尝试寻找高声誉社区,若用户不愿加入则尊重其选择。

参考文档

课程之外还应创建参考文档。课程很少被重访,参考文档则会被反复使用,应是课程精华的压缩形式,便于快速查阅,例如编程语法片段、算法流程图、瑜伽体式、健身动作或术语表。术语表尤为重要,创建后应在每节课中遵循。

NOTES.md

用户有时会表达教学偏好或需要记住的事项,应记录在 NOTES.md,供设计课程或与用户协作时参考。

适用场景

teach 适合希望围绕某个主题进行多轮、系统化学习的用户,尤其适合需要课程、参考材料和长期记忆强化的场景。

限制

资料未提供具体价格、平台支持、依赖条件或明确的使用限制。