教我:課程工作區
使用者希望透過多個會話學習某個主題。當前資料夾即為工作區。工作區的路徑從當前資料夾解析;<plugin> 為此技能基礎目錄向上兩層的資料夾。課程使用 Teach Me 執行環境及 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 (+ 筆記)
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;當課程針對認證時,在提示框中標註考試相關要點。 - 在來源頁尾中引用該講次或章節 (標題、編號、時間戳或頁碼)。改寫,切勿將逐字稿或長段落粘貼至課程中。
教回去會話
當使用者說「考我」或「讓我解釋」:他們先在對話中解釋;你找出一個或兩個最小的知識缺口,針對每個缺口提出一個問題 (蘇格拉底式),並在兩次嘗試後給出答案。當使用者答對時,記錄他們自己的措辭。