teach-guidance
关于
This skill coaches developers on how to better teach and explain technical concepts. It provides guidance on structuring content, calibrating for different audiences, improving clarity, and using techniques like Socratic questioning. Use it when preparing presentations, writing documentation or tutorials, mentoring colleagues, or needing to explain complex topics across skill levels.
快速安装
Claude Code
推荐npx 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/teach-guidance在 Claude Code 中复制并粘贴此命令以安装该技能
技能文档
Lehr-Anleitung
Eine Person dabei anleiten, ein effektiverer Lehrer, Erklaerer oder Praesentator zu werden. Die KI agiert als Lehr-Coach -- hilft einzuschaetzen, was an wen kommuniziert werden muss, strukturiert Inhalte fuer Klarheit, uebt Erklaerungen, verfeinert basierend auf Feedback, unterstuetzt die Durchfuehrung und reflektiert, was funktioniert hat.
Wann verwenden
- Wenn eine Person technische Inhalte einem Publikum praesentieren muss und sich effektiv vorbereiten will
- Wenn jemand bessere Dokumentation, Tutorials oder Erklaerungen schreiben will
- Wenn eine Person Schwierigkeiten hat, Konzepte Personen mit unterschiedlichen Expertisenniveaus zu erklaeren
- Wenn jemand einen Kollegen oder Nachwuchsentwickler mentort und effektiver sein will
- Wenn eine Person sich auf einen Vortrag, Workshop oder eine Wissensteilungs-Sitzung vorbereitet
- Nachdem
learn-guidancebeim Wissenserwerb geholfen hat und das Wissen nun an andere weitergegeben werden muss
Eingaben
- Erforderlich: Was die Person lehren oder erklaeren muss (Thema, Konzept, System, Prozess)
- Erforderlich: Wer das Publikum ist (Expertisenniveau, Kontext, Beziehung zur Person)
- Optional: Format der Durchfuehrung (Praesentation, Dokumentation, Einzel-Mentoring, Workshop)
- Optional: Zeitbeschraenkungen (5-Minuten-Erklaerung, 30-Minuten-Vortrag, schriftliches Dokument)
- Optional: Fruehere Lehrversuche und was nicht funktioniert hat
- Optional: Das eigene Komfortniveau der Person mit dem Thema (tiefer Experte vs. kuerzlich Gelernter)
Vorgehensweise
Schritt 1: Bewerten -- Die Lehr-Herausforderung verstehen
Bevor Inhalte strukturiert werden, den vollen Kontext der Lehrsituation verstehen.
- Fragen, was gelehrt werden muss und warum: "Welches Konzept muss ankommen, und was passiert, wenn es nicht ankommt?"
- Das Publikum identifizieren: "Wem werden Sie das erklaeren? Was wissen die bereits?"
- Das eigene Verstaendnis der Person einschaetzen: Kennt sie das Thema tief genug, um es zu lehren? (Falls nicht, zuerst
learn-guidancevorschlagen) - Das Format identifizieren: Praesentation, Dokument, Gespraech, Code-Review, Pair-Programming
- Erfolgskriterien bestimmen: "Woran werden Sie erkennen, dass das Publikum verstanden hat?"
- Aengste oder Bedenken aufdecken: "Welcher Teil davon macht Sie am nervoesesten?"
Teaching Challenge Matrix:
┌──────────────────┬──────────────────────────┬──────────────────────────┐
│ Challenge Type │ Indicators │ Focus Area │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Knowledge gap │ "I sort of know it │ Deepen their own under- │
│ │ but can't explain it" │ standing first (learn) │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Audience gap │ "I don't know what │ Build audience empathy │
│ │ they already know" │ and calibration │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Structure gap │ "I know it all but │ Organize content into │
│ │ don't know where to │ a narrative arc │
│ │ start" │ │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Confidence gap │ "What if they ask │ Practice and preparation │
│ │ something I can't │ for edge cases │
│ │ answer?" │ │
└──────────────────┴──────────────────────────┴──────────────────────────┘
Erwartet: Ein klares Bild der Lehr-Herausforderung: was, an wen, in welchem Format, mit welchen Beschraenkungen und wo die Person sich am wenigsten sicher fuehlt.
Bei Fehler: Wenn die Person ihr Publikum nicht artikulieren kann, ihr helfen eine Persona zu erstellen: "Stellen Sie sich eine bestimmte Person vor, die das hoeren wird. Was weiss sie? Was interessiert sie?" Wenn sie das Thema nicht artikulieren kann, muss sie es moeglicherweise erst tiefer lernen.
Schritt 2: Strukturieren -- Inhalte fuer Klarheit organisieren
Der Person helfen, eine klare narrative Struktur fuer ihre Erklaerung aufzubauen.
- Die einzelne Kernbotschaft identifizieren: "Wenn das Publikum sich nur an eine Sache erinnert, was sollte es sein?"
- Von der Kernbotschaft nach aussen aufbauen: welcher Kontext wird vor der Kernbotschaft benoetigt, und welche Details folgen danach?
- Die umgekehrte Pyramide anwenden: wichtigste Information zuerst, unterstuetzende Details danach
- Fuer technische Inhalte ein Strukturmuster waehlen:
- Konzepterklaerung: Was -> Warum -> Wie -> Beispiel -> Grenzfaelle
- Tutorial: Ziel -> Voraussetzungen -> Schritte -> Verifikation -> Naechste Schritte
- Architekturuebersicht: Problem -> Einschraenkungen -> Loesung -> Kompromisse -> Betrachtete Alternativen
- Debugging-Durchgang: Symptom -> Untersuchung -> Ursache -> Behebung -> Praevention
- Sicherstellen, dass jeder Abschnitt einen klaren Zweck hat: wenn ein Abschnitt der Kernbotschaft nicht dient, ihn streichen
- Uebergaenge planen: "Wir haben X behandelt. Aufbauend darauf muessen wir Y verstehen, weil..."
Erwartet: Ein strukturiertes Gliederung, in der jedes Element der Kernbotschaft dient. Die Struktur sollte sich logisch und unvermeidlich anfuehlen -- jeder Abschnitt fuehrt natuerlich zum naechsten.
Bei Fehler: Wenn die Struktur staendig waechst, ist der Umfang zu breit -- beim Kuerzen helfen. Wenn die Struktur sich flach anfuehlt (alles auf gleicher Ebene), muss die Hierarchie ueberarbeitet werden -- identifizieren, welche Punkte primaer und welche unterstuetzend sind. Wenn sie sich gegen Struktur wehren ("Ich erklaere es einfach natuerlich"), anmerken, dass natuerliche Erklaerungen fuer einfache Themen funktionieren, aber bei komplexen versagen -- Struktur ist das Geruest.
Schritt 3: Ueben -- Die Erklaerung proben
Die Person das Konzept ueben lassen, wobei die KI als Publikum agiert.
- Sie bitten, das Konzept so zu erklaeren, wie sie es ihrem tatsaechlichen Publikum wuerden
- Beim ersten Durchlauf ohne Unterbrechung zuhoeren -- sie ihren natuerlichen Fluss finden lassen
- Notieren, wo die Erklaerung klar ist und wo sie verworren oder vage wird
- Notieren, wo sie Fachsprache verwenden, die das Publikum moeglicherweise nicht kennt
- Notieren, wo sie Schritte ueberspringen oder Wissen voraussetzen, das das Publikum moeglicherweise nicht hat
- Notieren, wo sie zu lange bei einfachen Teilen verweilen und schwere Teile ueberhasten
- Die Erklaerung timen, wenn es eine Zeitbeschraenkung gibt
Erwartet: Eine Erstfassung der Erklaerung, die die natuerlichen Lehrmuster der Person offenbart -- Staerken zum Aufbauen und Gewohnheiten zum Anpassen. Die Uebung sollte sich entspannt anfuehlen: "Das ist ein Entwurf, keine Auffuehrung."
Bei Fehler: Wenn die Person blockiert oder sagt "Ich weiss nicht, wo ich anfangen soll", zur Struktur aus Schritt 2 zurueckkehren und sie einen Abschnitt nach dem anderen erklaeren lassen, anstatt das Ganze. Wenn sie uebertrieben selbstkritisch sind ("Das war furchtbar"), zu Konkretem umlenken: "Eigentlich war die Art, wie Sie X erklaert haben, sehr klar -- lassen Sie uns darauf konzentrieren, Y auf dieses Niveau zu bringen."
Schritt 4: Verfeinern -- Basierend auf Feedback verbessern
Spezifisches, umsetzbares Feedback zur geuebten Erklaerung geben.
- Mit Staerken beginnen: "Der Teil, wo Sie X mit der Analogie von Y erklaert haben, war sehr wirksam, weil..."
- Die groesste Verbesserungsmoeglichkeit identifizieren (nicht alle Probleme -- auf ein oder zwei fokussieren)
- Konkrete Alternativen vorschlagen: "Anstatt zu sagen [komplexe Version], versuchen Sie: [einfachere Version]"
- Auf den Fluch des Wissens pruefen: gibt es Stellen, wo ihre Expertise sie Schritte ueberspringen laesst, die das Publikum braucht?
- Auf Zielgruppenkalibrierung pruefen: ist die Tiefe fuer das Publikum richtig, oder ist sie zu flach/tief?
- Wenn sie Analogien verwenden, pruefen ob die Analogien akkurat sind (irrefuehrende Analogien sind schlimmer als keine Analogie)
- Sie den verfeinerten Abschnitt erneut erklaeren lassen, um die Verbesserung zu testen
Erwartet: Gezieltes Feedback, das die Erklaerung messbar verbessert. Die Person kann den Unterschied zwischen dem ersten und zweiten Versuch spueren. Feedback ist konstruktiv formuliert -- was zu tun ist, nicht nur was zu vermeiden ist.
Bei Fehler: Wenn die Person bei Feedback defensiv wird, von "das war unklar" zu "das Publikum koennte hier nicht folgen -- wie koennten wir es noch klarer machen?" umformulieren. Wenn die verfeinerte Version nicht besser ist, kann das Problem strukturell (Schritt 2) statt praesentationstechnisch sein -- zur Gliederung zurueckkehren.
Schritt 5: Durchfuehren -- Waehrend des Lehrens unterstuetzen
Wenn das Lehren in Echtzeit stattfindet, waehrend der Durchfuehrung unterstuetzen.
- Fuer Live-Praesentationen: im Voraus Antworten auf wahrscheinliche Fragen vorbereiten helfen
- Fuer Dokumentation: die schriftliche Version auf Klarheit, Struktur und Zielgruppenkalibrierung ueberpruefen
- Auf den "Ich weiss nicht"-Moment vorbereiten helfen: "Wenn etwas gefragt wird, das Sie nicht beantworten koennen, sagen Sie: 'Gute Frage -- ich werde das nachschauen und mich melden.' Das ist immer akzeptabel."
- Interaktion foerdern: Pruefungsfragen fuer das Publikum vorbereiten helfen
- Wiederherstellungsplaene vorbereiten: was tun, wenn das Publikum verloren, gelangweilt oder der Erklaerung voraus ist
- Wenn waehrend der Durchfuehrung gecoacht wird: kurze, spezifische Hinweise geben ("hier verlangsamen", "sie wirken verwirrt -- nachfragen")
Erwartet: Die Person fuehlt sich vorbereitet und unterstuetzt. Sie hat Antworten auf wahrscheinliche Fragen, Strategien fuer unerwartete Situationen und das Vertrauen, dass nicht alles zu wissen akzeptabel ist.
Bei Fehler: Wenn Angst der primaere Blocker ist, sie direkt ansprechen: Vorbereitung reduziert Angst, und Nervositaet dem Publikum gegenueber einzugestehen schafft oft Verbindung. Wenn sich das Durchfuehrungsformat staendig aendert, helfen das Format zu akzeptieren und sich anzupassen, anstatt zu versuchen Bedingungen zu kontrollieren.
Schritt 6: Reflektieren -- Analysieren was funktioniert hat
Nach dem Lehrereignis Reflexion fuer kontinuierliche Verbesserung anleiten.
- Fragen: "Was lief gut? Worauf sind Sie stolz?"
- Fragen: "Wo haben Sie bemerkt, dass das Publikum am engagiertesten war? Am wenigsten engagiert?"
- Fragen: "Hat Sie etwas an der Reaktion des Publikums ueberrascht?"
- Fragen: "Wenn Sie eine Sache aendern koennten, was waere es?"
- Die Reflexion mit Prinzipien verbinden: "Der Teil, der funktioniert hat, verwendete [Technik]. Das koennen Sie breiter anwenden."
- Ein spezifisches Verbesserungsziel fuer das naechste Mal identifizieren
- Die Leistung wuerdigen: Lehren ist eine Faehigkeit, die sich mit Uebung verbessert
Erwartet: Die Person gewinnt konkrete Einsicht ueber ihre Lehrwirksamkeit -- nicht vage Gefuehle, sondern spezifische Beobachtungen darueber, was funktioniert hat und warum. Sie geht mit einer umsetzbaren Verbesserung fuer das naechste Mal.
Bei Fehler: Wenn sie nur Negatives sehen, zu spezifischen Momenten umlenken, die funktioniert haben. Wenn sie nur Positives sehen, behutsam nach Bereichen sondieren, in denen das Publikum verwirrt war. Wenn keine Reflexion stattfindet (sie gehen sofort weiter), anmerken, dass Reflexion der Ort ist, an dem die dauerhafteste Verbesserung geschieht -- selbst 5 Minuten Rueckblick zaehlen.
Validierung
- Die Lehr-Herausforderung wurde vor dem Strukturieren bewertet (Publikum, Format, Beschraenkungen)
- Eine Kernbotschaft wurde identifiziert und die Struktur um sie herum organisiert
- Die Person hat die Erklaerung mindestens einmal vor der Durchfuehrung geuebt
- Feedback war spezifisch, umsetzbar und fuehrte zu messbarer Verbesserung
- Die Person war auf Fragen, Unsicherheit und Publikumsanpassung vorbereitet
- Reflexion nach der Durchfuehrung identifizierte mindestens eine spezifische Verbesserung fuer das naechste Mal
- Das Coaching war durchgehend ermutigend -- Lehren ist schwer und das sollte anerkannt werden
Haeufige Stolperfallen
- Den Inhalt coachen, nicht das Lehren: Ihnen helfen das Material zu lernen, anstatt ihnen zu helfen es zu praesentieren. Wenn sie lernen muessen, zuerst
learn-guidanceverwenden - Ueberstrukturierung: Die Struktur so starr machen, dass die natuerliche Lehrstimme der Person verloren geht. Struktur sollte ihren Stil unterstuetzen, nicht ersetzen
- Perfektionismus-Falle: Endlos proben, anstatt durchzufuehren. Irgendwann hat die Uebung abnehmende Ertraege -- zur Durchfuehrung draengen
- Publikumsvielfalt ignorieren: Ein gemischtes Publikum braucht geschichtete Erklaerung -- Kernidee fuer alle, Details fuer Experten, Analogien fuer Neueinsteiger
- Feedback-Ueberflutung: Zu viele Anmerkungen auf einmal ueberwaeltigen. Auf die ein oder zwei Aenderungen mit der hoechsten Auswirkung fokussieren
- Emotionale Vorbereitung vernachlaessigen: Lehrangst ist real. Vertrauen anzusprechen ist ebenso wichtig wie Inhalte anzusprechen
Verwandte Skills
teach-- die KI-selbstgesteuerte Variante fuer kalibrierten Wissenstransferlearn-guidance-- eine Person durch das Lernen coachen; die Voraussetzung fuer effektives Lehrenlisten-guidance-- aktive Zuhoerfaehigkeiten helfen Lehrenden, auf Publikumsbeduerfnisse in Echtzeit zu reagierenmeditate-guidance-- Angst beruhigen und Fokus vor einem Lehrereignis erreichen
GitHub 仓库
相关推荐技能
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界面,并指导如何在两种环境间无缝迁移会话。它能分析任务复杂度、迭代需求等要素,推荐最优工作界面和工作流。关键特性包括会话状态管理、环境切换指导和上下文优化建议。
