Communitygithub.com

NourEldinShobier/课程工作区

在当前文件夹中启动或继续一个多会话的学习工作区——包含任务目标、精选资源、学习记录、编号互动课程、参考表、术语表、闪卡复习,以及用于逐章学习课程(Udemy、YouTube播放列表)或书籍的队列。

课程工作区 是什么?

这是一个用于在本地工作区中进行多会话、结构化学习的AI助手技能。它适用于Claude Code等能够读写文件的AI编码代理。该技能会建立并维护一个完整的学习环境,包含任务目标(MISSION.md)、精选资源(RESOURCES.md)、术语表(GLOSSARY.md)、工作笔记(NOTES.md)、学习记录、编号互动课程、闪卡复习(review.src.html)以及一个用于处理课程或书籍的队列(queue.json)。每个会话都会读取当前状态,进行暖身复习,然后教授一个新概念——构建为一个互动HTML课程。对于Udemy课程、YouTube播放列表或书籍,该技能可以辅助用户从课程大纲或目录创建处理队列,一次只处理一个项目,获取最相关的字幕或文本,并避免预先下载整个课程资料。它支持教学反馈会话,当用户说“测试我”或“让我解释”时,用户先解释,AI找出最小的知识缺口并苏格拉底式地提问,在两次尝试后给出答案。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NourEldinShobier/teach-me/tree/master/skills/course

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

教我:课程工作区

用户希望通过多个会话学习某个主题。当前文件夹是工作区。工作区路径从当前文件夹解析;<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)

每次会话

  1. 读取状态:MISSION.md、NOTES.md、最新的学习记录、queue.json。如果没有 MISSION.md,首先访谈用户(为什么学、成功标准、截止日期、当前水平、限制条件),并按照格式文件的形状写入。之后更改任务需要用户确认并记录一条学习记录。
  2. 资源:在 RESOURCES.md 拥有几个高信任度条目之前,寻找它们是首要任务(官方文档、标准教科书、课程本身、一两个社区获取智慧)。严格精简。
  3. 暖身:在聊天中从之前的课程(不是今天的内容)提出两个回顾问题。提到有多少闪卡到期,并提供 review.html。
  4. 选择课程:用户请求的内容,否则是下一个 queued 项目,再否则是根据记录和任务在用户最近发展区内最有用的内容。
  5. 教授一个概念:构建 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 中列出的比喻;将新比喻添加到那里。
  6. 结束:更新队列,将课程的卡片添加到 review.src.html(每个牌组一个 cards 组件,使用与课程相同的 deck 和卡片ID,以便进度延续),并重新构建。每三节课,或应要求,将参考表提炼到 reference/。
  7. 记录:当用户粘贴课程进度或在聊天中展示理解时,仅记录证据(参见 <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;绝不要将转录或长段落粘贴到课程中。

教学反馈会话

当用户说“测试我”或“让我解释”时:用户先在聊天中解释;你找出一两个最小的知识缺口,每个缺口问一个问题(苏格拉底式),并在两次尝试后给出答案。当用户答对时,记录他们自己的措辞。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能