返回技能列表

teach

pjt222
更新于 5 days ago
11 次查看
17
2
17
在 GitHub 上查看
设计aidesign

关于

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.

快速安装

Claude Code

推荐
主要方式
npx skills add pjt222/agent-almanac -a claude-code
插件命令备选方式
/plugin add https://github.com/pjt222/agent-almanac
Git 克隆备选方式
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/teach

在 Claude Code 中复制并粘贴此命令以安装该技能

技能文档

行結構化之知識傳遞——評估學習者當前理解、自已知至未知設鷹架、以校準之深度解釋、藉提問檢理解、依回饋調整、以實踐強化。

適用時機

  • 用戶問「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.    │
└──────────────┴────────────────────────────┴──────────────────────────┘
  1. 審用戶所言:其問、詞彙、所述目標
  2. 對此特定主題分類其可能等級(人於某域可為高階而於另一為新手)
  3. 識別 Vygotsky 近側發展區(ZPD):剛超其當前所及但於支援下可達者
  4. 註任何於正模型可落地前須處理之誤解
  5. 識別最佳入點:其所知者與所需學者之連結?

預期: 對下列之清晰圖:學習者所知、所需知與連兩者之橋。評估應具體至可擇解釋策略。

失敗時: 若學習者等級不清,問校準題:「你熟 [先備概念] 嗎?」此非測驗——而為集資料以更佳教之。若問感尷尬,預設中階並依其應調整。

步驟二:設鷹架——橋已知至未知

自學習者已理解者築至新概念之路。

  1. 識別錨:學習者必懂且與目標相關之一概念
  2. 明示連結:「你所知之 X 於此新脈絡中如 Y 般運作,因為...」
  3. 一次引一新念——勿於同句中含二新概念
  4. 具體例先於抽象原則
  5. 建層次複雜:先簡單版,再加細
  6. 若先備缺,先教先備(小鷹架)再回主概念

預期: 設鷹架之路,每步建於前。學習者永不應感迷失,因每新念皆連於其已持者。

失敗時: 若已知與未知間之差過大而無法以單一鷹架,拆為多個較小步。若無熟錨(全新領域),用學習者所知之另域之類比。若類比不完美,承認其限:「此如 X,除...外」。

步驟三:解釋——校準深度與風格

以正等級、正模式遞解釋。

  1. 以核心念於一句開——標題先於文章
  2. 以步驟二建之鷹架擴之
  3. 用學習者之詞彙,非該域之術語(除非高階)
  4. 對代碼概念:示最小可運作例,非全面者
  5. 對抽象概念:先提具體實例,再推廣
  6. 對流程:逐步走特定案例,再陳一般規則
  7. 監困惑徵:若下問未建於解釋,解釋未落地

預期: 學習者獲既不淺(留問)亦不深(以多餘細節壓倒)之解釋。解釋用其語並連其脈絡。

失敗時: 若解釋過長,核心念或被埋——重述一句之標題。若解釋後學習者更困惑,入點錯——試他錨或類比。若概念實為複雜,承認複雜而非藏之:「此有三部分且互動。我自第一始。」

步驟四:檢——驗理解

勿假設解釋有效。以揭學習者心智模型之問測之。

  1. 問需應用而非回憶之題:「給 X,你料何發生?」
  2. 求轉述:「能以你自己之話解釋此嗎?」
  3. 提變化:「若改此一物呢?」
  4. 尋具體理解:能否預測,非僅重複?
  5. 若答揭誤解,註特定錯供步驟五
  6. 若答正確,略推:能否推廣?

預期: 檢揭學習者是否有運作之心智模型,或僅鸚鵡學舌解釋。運作模型可處變化;記憶之解釋不能。

失敗時: 若學習者無法答檢題,解釋未建正心智模型。此非其失敗——而為對教之回饋。註具體未落地處並進步驟五。

步驟五:調整——應對回饋

依檢結果調教法。

  1. 若理解紮實:進至強化(步驟六)或進下一概念
  2. 若有特定誤解:以證據而非重複直接處之
  3. 若有一般困惑:試完全不同之解釋法
  4. 若學習者超評估:加速——略鷹架直入細
  5. 若學習者落後評估:減速——教其所缺之先備
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.   │
└──────────────────┴─────────────────────────────────────────────────┘

預期: 教即時依回饋調。無解釋以完全相同法重複——每重試用不同法。調整應感回應,非機械。

失敗時: 若多次調整嘗試皆失,問題或為基礎至雙方皆未識之先備缺。明問:「解釋之何部分感跳得最大?」此常揭隱藏之缺。

步驟六:強化——提供實踐

以應用而非重複固化理解。

  1. 提需新概念之練習題(非陷阱題)
  2. 若於編碼脈絡:建議用此概念對既碼小修
  3. 若於概念脈絡:呈情境並請其應用模型
  4. 連向前:「既已懂 X,此連 Y,可下次探」
  5. 提供獨立探索之參考材料:文件連結、相關文件、進一步閱讀
  6. 閉環:「總結我們所及...」——核心概念一句

預期: 學習者已至少應用概念一次,並具持續學習之資源。摘要為未來回憶錨定學習。

失敗時: 若練習題過難,教跳得太遠——簡化問題。若學習者可做練習但無法解其因,其有程序知識而無概念理解——回步驟三聚焦於「為何」而非「如何」。

驗證

  • 解釋始前已評估學習者等級
  • 解釋自已知至未知設鷹架,非以資料傾倒交付
  • 至少問一檢題以驗理解(非假設)
  • 教依回饋調而非重複同解釋
  • 學習者可應用概念,非僅回憶解釋
  • 誠實之缺已承認而非粉飾

常見陷阱

  • 知識之詛咒:忘學習者未共享教者之脈絡。術語、假設之先備與隱推理步為主犯
  • 為印象而解釋而非為教:全面、技術精確之解釋示知識卻棄學習者於後
  • 重複而更大聲:解釋未落地時以更強調重複而非試他法
  • 以測代教:以檢題作捕捉物而非診斷工具。目的為揭理解,非捕失敗
  • 假設靜默為理解:問之缺非示解釋有效——常意學習者不知問何
  • 一刀切之深:以「應懂全圖」為新手予高階解釋將壓垮;以「保險為佳」予專家初學者解釋浪費其時

相關技能

  • teach-guidance — 為人成為更佳教者之教練之人引導變體
  • learn — 系統知識獲取,建可教之之理解
  • listen — 深受性注意,揭學習者所述問外之實需
  • meditate — 教學集間清假設以新鮮對待每學習者

GitHub 仓库

pjt222/agent-almanac
路径: i18n/wenyan-lite/skills/teach
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

相关推荐技能

executing-plans

设计

该Skill用于当开发者提供完整实施计划时,以受控批次方式执行代码实现。它会先审阅计划并提出疑问,然后分批次执行任务(默认每批3个任务),并在批次间暂停等待审查。关键特性包括分批次执行、内置检查点和架构师审查机制,确保复杂系统实现的可控性。

查看技能

requesting-code-review

设计

该Skill可在完成任务、实现主要功能或合并代码前自动调度代码审查子代理,确保实现符合需求和计划。它支持通过指定git SHA范围进行精准的代码变更审查,帮助开发者在关键节点及时发现潜在问题。核心原则是"早审查、勤审查",适用于开发流程的各个关键阶段。

查看技能

connect-mcp-server

设计

这个Skill指导开发者如何将MCP服务器连接到Claude Code,支持HTTP、stdio和SSE三种传输协议。它涵盖了从安装配置到认证安全的完整流程,适用于集成GitHub、Notion、数据库等外部服务。当开发者需要添加集成、配置外部工具或提及MCP相关功能时,这个Skill能提供实用的操作指南。

查看技能

web-cli-teleport

设计

该Skill帮助开发者根据任务特性选择Claude Code的Web或CLI界面,并指导如何在两种环境间无缝迁移会话。它能分析任务复杂度、迭代需求等要素,推荐最优工作界面和工作流。关键特性包括会话状态管理、环境切换指导和上下文优化建议。

查看技能