teach
About
The `teach` skill provides structured knowledge transfer by assessing a learner's understanding and scaffolding explanations from known to unknown concepts. It employs Socratic questioning to verify comprehension and adapts its explanations based on learner feedback. Use this skill when a user asks "how does X work?", reveals a conceptual gap, or needs a complex concept broken down from its prerequisites.
Quick Install
Claude Code
Recommendednpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/teachCopy and paste this command in Claude Code to install this skill
Documentation
教
行結構化之知識傳遞——評估學習者當前理解、自已知至未知設鷹架、以校準之深度解釋、藉提問檢理解、依回饋調整、以實踐強化。
適用時機
- 用戶問「X 如何運作?」而答需逐級解釋,非資料傾倒
- 用戶之問揭示其當前理解與所需知間之差距
- 先前解釋未落地——用戶困惑或以不同方式問同問
- 教含用戶或無之先備條件之概念
learn已建深心智模型而今需有效溝通
輸入
- 必要:欲教之概念、系統或技能
- 必要:學習者(隱式可用——對話中之用戶)
- 選擇性:已知學習者背景(專業度、背景、所述目標)
- 選擇性:先前失敗之解釋(已試者)
- 選擇性:時間/深度限制(速覽 vs. 深理解)
步驟
步驟一:評估——繪學習者
於解任何前,定學習者已知者與所需者。
Learner Calibration Matrix:
┌──────────────┬────────────────────────────┬──────────────────────────┐
│ Level │ Explanation Pattern │ Check Pattern │
├──────────────┼────────────────────────────┼──────────────────────────┤
│ Novice │ Analogy-first. Connect to │ "In your own words, what │
│ (no domain │ familiar concepts. Avoid │ does X do?" Accept any │
│ vocabulary) │ jargon entirely. Concrete │ correct paraphrase. │
│ │ before abstract. │ │
├──────────────┼────────────────────────────┼──────────────────────────┤
│ Intermediate │ Build on existing vocab. │ "What would happen if │
│ (knows terms,│ Fill gaps with targeted │ we changed Y?" Tests │
│ some gaps) │ explanations. Use code │ whether they can predict │
│ │ examples that are close │ from understanding. │
│ │ to their existing work. │ │
├──────────────┼────────────────────────────┼──────────────────────────┤
│ Advanced │ Skip fundamentals. Focus │ "How would you compare │
│ (strong base,│ on nuance, trade-offs, │ X to Z approach?" Tests │
│ seeks depth) │ edge cases. Reference │ integration and judgment. │
│ │ source material directly. │ │
├──────────────┼────────────────────────────┼──────────────────────────┤
│ Misaligned │ Correct gently. Provide │ "Let me check my under- │
│ (confident │ the right model alongside │ standing — you're saying │
│ but wrong) │ why the wrong model feels │ X?" Mirror back to │
│ │ right. No shame signals. │ surface the mismatch. │
└──────────────┴────────────────────────────┴──────────────────────────┘
- 審用戶所言:其問、詞彙、所述目標
- 對此特定主題分類其可能等級(人於某域可為高階而於另一為新手)
- 識別 Vygotsky 近側發展區(ZPD):剛超其當前所及但於支援下可達者
- 註任何於正模型可落地前須處理之誤解
- 識別最佳入點:其所知者與所需學者之連結?
預期: 對下列之清晰圖:學習者所知、所需知與連兩者之橋。評估應具體至可擇解釋策略。
失敗時: 若學習者等級不清,問校準題:「你熟 [先備概念] 嗎?」此非測驗——而為集資料以更佳教之。若問感尷尬,預設中階並依其應調整。
步驟二:設鷹架——橋已知至未知
自學習者已理解者築至新概念之路。
- 識別錨:學習者必懂且與目標相關之一概念
- 明示連結:「你所知之 X 於此新脈絡中如 Y 般運作,因為...」
- 一次引一新念——勿於同句中含二新概念
- 具體例先於抽象原則
- 建層次複雜:先簡單版,再加細
- 若先備缺,先教先備(小鷹架)再回主概念
預期: 設鷹架之路,每步建於前。學習者永不應感迷失,因每新念皆連於其已持者。
失敗時: 若已知與未知間之差過大而無法以單一鷹架,拆為多個較小步。若無熟錨(全新領域),用學習者所知之另域之類比。若類比不完美,承認其限:「此如 X,除...外」。
步驟三:解釋——校準深度與風格
以正等級、正模式遞解釋。
- 以核心念於一句開——標題先於文章
- 以步驟二建之鷹架擴之
- 用學習者之詞彙,非該域之術語(除非高階)
- 對代碼概念:示最小可運作例,非全面者
- 對抽象概念:先提具體實例,再推廣
- 對流程:逐步走特定案例,再陳一般規則
- 監困惑徵:若下問未建於解釋,解釋未落地
預期: 學習者獲既不淺(留問)亦不深(以多餘細節壓倒)之解釋。解釋用其語並連其脈絡。
失敗時: 若解釋過長,核心念或被埋——重述一句之標題。若解釋後學習者更困惑,入點錯——試他錨或類比。若概念實為複雜,承認複雜而非藏之:「此有三部分且互動。我自第一始。」
步驟四:檢——驗理解
勿假設解釋有效。以揭學習者心智模型之問測之。
- 問需應用而非回憶之題:「給 X,你料何發生?」
- 求轉述:「能以你自己之話解釋此嗎?」
- 提變化:「若改此一物呢?」
- 尋具體理解:能否預測,非僅重複?
- 若答揭誤解,註特定錯供步驟五
- 若答正確,略推:能否推廣?
預期: 檢揭學習者是否有運作之心智模型,或僅鸚鵡學舌解釋。運作模型可處變化;記憶之解釋不能。
失敗時: 若學習者無法答檢題,解釋未建正心智模型。此非其失敗——而為對教之回饋。註具體未落地處並進步驟五。
步驟五:調整——應對回饋
依檢結果調教法。
- 若理解紮實:進至強化(步驟六)或進下一概念
- 若有特定誤解:以證據而非重複直接處之
- 若有一般困惑:試完全不同之解釋法
- 若學習者超評估:加速——略鷹架直入細
- 若學習者落後評估:減速——教其所缺之先備
Adaptation Responses:
┌──────────────────┬─────────────────────────────────────────────────┐
│ Signal │ Adaptation │
├──────────────────┼─────────────────────────────────────────────────┤
│ "I think I get │ Push gently: "Great — so what would happen │
│ it" │ if...?" Verify before moving on. │
├──────────────────┼─────────────────────────────────────────────────┤
│ "I'm confused" │ Change modality: if verbal, show code. If code, │
│ │ use analogy. If analogy, draw a diagram. │
├──────────────────┼─────────────────────────────────────────────────┤
│ "But what about │ Good sign — they are testing the model. Address │
│ [edge case]?" │ the edge case, which deepens understanding. │
├──────────────────┼─────────────────────────────────────────────────┤
│ "That doesn't │ They have a competing model. Explore it: "What │
│ seem right" │ do you think happens instead?" Reconcile the two.│
├──────────────────┼─────────────────────────────────────────────────┤
│ Silence or │ They may be processing, or lost. Ask: "What │
│ topic change │ part feels least clear?" Lower the bar gently. │
└──────────────────┴─────────────────────────────────────────────────┘
預期: 教即時依回饋調。無解釋以完全相同法重複——每重試用不同法。調整應感回應,非機械。
失敗時: 若多次調整嘗試皆失,問題或為基礎至雙方皆未識之先備缺。明問:「解釋之何部分感跳得最大?」此常揭隱藏之缺。
步驟六:強化——提供實踐
以應用而非重複固化理解。
- 提需新概念之練習題(非陷阱題)
- 若於編碼脈絡:建議用此概念對既碼小修
- 若於概念脈絡:呈情境並請其應用模型
- 連向前:「既已懂 X,此連 Y,可下次探」
- 提供獨立探索之參考材料:文件連結、相關文件、進一步閱讀
- 閉環:「總結我們所及...」——核心概念一句
預期: 學習者已至少應用概念一次,並具持續學習之資源。摘要為未來回憶錨定學習。
失敗時: 若練習題過難,教跳得太遠——簡化問題。若學習者可做練習但無法解其因,其有程序知識而無概念理解——回步驟三聚焦於「為何」而非「如何」。
驗證
- 解釋始前已評估學習者等級
- 解釋自已知至未知設鷹架,非以資料傾倒交付
- 至少問一檢題以驗理解(非假設)
- 教依回饋調而非重複同解釋
- 學習者可應用概念,非僅回憶解釋
- 誠實之缺已承認而非粉飾
常見陷阱
- 知識之詛咒:忘學習者未共享教者之脈絡。術語、假設之先備與隱推理步為主犯
- 為印象而解釋而非為教:全面、技術精確之解釋示知識卻棄學習者於後
- 重複而更大聲:解釋未落地時以更強調重複而非試他法
- 以測代教:以檢題作捕捉物而非診斷工具。目的為揭理解,非捕失敗
- 假設靜默為理解:問之缺非示解釋有效——常意學習者不知問何
- 一刀切之深:以「應懂全圖」為新手予高階解釋將壓垮;以「保險為佳」予專家初學者解釋浪費其時
相關技能
teach-guidance— 為人成為更佳教者之教練之人引導變體learn— 系統知識獲取,建可教之之理解listen— 深受性注意,揭學習者所述問外之實需meditate— 教學集間清假設以新鮮對待每學習者
GitHub Repository
Related Skills
executing-plans
DesignUse the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.
requesting-code-review
DesignThis skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.
connect-mcp-server
DesignThis skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.
web-cli-teleport
DesignThis skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.
