教我:课程工作区
用户希望通过多个会话学习某个主题。当前文件夹是工作区。工作区路径从当前文件夹解析;<plugin> 是该技能基础目录向上两层的文件夹。课程使用“教我”运行时和 learn 技能的步骤 2-6(<plugin>/skills/learn/SKILL.md)。
布局遵循 Matt Pocock 的 teach 技能(MIT 许可),因此两个工具可以在同一文件夹中工作。
MISSION.md 用户为什么要学习这个 <plugin>/references/workspace/MISSION-FORMAT.md
RESOURCES.md 精选来源:知识、社区、知识缺口 RESOURCES-FORMAT.md
GLOSSARY.md 用户正确使用过的术语 GLOSSARY-FORMAT.md
NOTES.md 用户的偏好、你的工作笔记、已经使用过的比喻
learning-records/ 0001-slug.md:他们已知知识的证据 LEARNING-RECORD-FORMAT.md
lessons/ 0001-slug.src.html -> 0001-slug.html (+ notes)
reference/ 速查表:精简、可打印、经常回顾
queue.json 集数或章节队列
review.src.html 所有课程中的闪卡,到期优先
sources/ 原始转录和章节文本(添加到 .gitignore)
每次会话
- 读取状态:
MISSION.md、NOTES.md、最新的学习记录、queue.json。如果没有MISSION.md,首先访谈用户(为什么学、成功标准、截止日期、当前水平、限制条件),并按照格式文件的形状写入。之后更改任务需要用户确认并记录一条学习记录。 - 资源:在
RESOURCES.md拥有几个高信任度条目之前,寻找它们是首要任务(官方文档、标准教科书、课程本身、一两个社区获取智慧)。严格精简。 - 暖身:在聊天中从之前的课程(不是今天的内容)提出两个回顾问题。提到有多少闪卡到期,并提供
review.html。 - 选择课程:用户请求的内容,否则是下一个
queued项目,再否则是根据记录和任务在用户最近发展区内最有用的内容。 - 教授一个概念:构建
lessons/NNNN-slug.src.html(下一个编号),遵循learn技能的步骤 2-6,但在工作区中构建:bun <plugin>/scripts/build.ts lessons/NNNN-slug.src.html,然后bun <plugin>/scripts/check.ts lessons/NNNN-slug.html。链接前后课程和相关参考表。精确重用术语表中的术语。不要重用NOTES.md中列出的比喻;将新比喻添加到那里。 - 结束:更新队列,将课程的卡片添加到
review.src.html(每个牌组一个cards组件,使用与课程相同的deck和卡片ID,以便进度延续),并重新构建。每三节课,或应要求,将参考表提炼到reference/。 - 记录:当用户粘贴课程进度或在聊天中展示理解时,仅记录证据(参见
<plugin>/references/pedagogy.md)。将用户正确使用的术语提升到术语表中。
学习课程或书籍
queue.json:
{"source": {"kind": "udemy|youtube|book", "title": "…", "url": "…", "file": "…", "courseId": "…"},
"items": [{"id": "lecture-or-chapter-id", "title": "…", "section": "…", "status": "queued|taught|skipped", "lesson": "lessons/0004-….html"}]}
- 一次性构建队列,从课程大纲或目录(
<plugin>/references/inputs.md:Udemy 课程大纲接口,yt-dlp -J用于播放列表,PDF 大纲或 EPUB 脊柱)。默认跳过简介、结尾、宣传和测验;如果不确定则询问一次。 - 每节课一个项目。 仅在你讲授该节课时获取该集数的字幕或该章节的文本。从不预取整个课程。
- “下一个” 表示下一个
queued项目。用户也可以指定项目名称或范围(“讲座 12-14 作为一节课”、“仅第 3 章第 2 节”)。 - 集数或章节课程使用
notes格式(技术类)或practice格式(软技能、生活、非虚构):用用户自己的术语写一个简短的易读摘要、核心思想图示、讲师或作者强调的内容、常见错误、测验和闪卡。添加“这适合哪里”链接到之前的课程。对于 AWS 风格课程,首选带有请求跟踪和“如果……会怎样”问题的diagram;如果课程针对认证,用标注框标注考试相关事实。 - 在来源页脚中引用讲座或章节(标题、编号、时间戳或页码)。要 paraphrase;绝不要将转录或长段落粘贴到课程中。
教学反馈会话
当用户说“测试我”或“让我解释”时:用户先在聊天中解释;你找出一两个最小的知识缺口,每个缺口问一个问题(苏格拉底式),并在两次尝试后给出答案。当用户答对时,记录他们自己的措辞。