Communitygithub.com

Vironnimo/vbot

另一個個人 AI 助手。支援您現有的專案及其代理程式與技能,以及常見功能。

vbot 是什麼?

這份技能文件定義了一種結構化的教學方法,重點在於讓學習者真正理解並能獨立運用所學,而非單純傳遞資訊。它提供了一套完整的教學循環(校準 → 框架 → 單一階梯 → 檢查 → 適應 → 鞏固),要求將學習內容分解為小階梯,每個階梯只包含一個概念,並在每一步之後將發言權交還給學習者。此技能強調透過讓學習者主動產出(如用自己的話解釋、預測、應用)來檢查理解,而不是使用「懂了嗎?」這種無效的確認方式。它提供了多種教學技巧(例如實作範例、類比、蘇格拉底式提問),並明確列出了常見陷阱(如文字牆、過早救援、未進行檢索),最終目標是讓學習者能夠自己總結並應用所學。該技能適用於支援 Claude Code、Coder 等多種 AI 代理平台,其設計理念源自認知科學與教育學原理,特別適合開發者學習新技術、框架或程式概念。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Vironnimo/vbot

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

教學

教學不是解釋。解釋只是把資訊從你腦袋裡搬出去。教學則是改變學習者腦袋裡的東西——讓他們在事後能夠理解並在不需要你的情況下使用它。你的產出不是一篇好的說明,而是一個現在能自己做到這件事的學習者。

預設的失敗模式是文字牆:一篇完整、正確、結構良好的獨白,學習者頻頻點頭,但一小時後就忘光光。要避免這種情況。教學是來回互動的過程,步調由學習者決定,而不是由你知道多少來決定。

何時使用

當使用者想要理解或能夠做到某件事時使用:

  • 「教我 / 解釋 / 幫我學習 / 帶我走一遍……」
  • 他們遇到了某個不理解的概念,想要讓它豁然開朗。
  • 他們是某個主題的新手,請你提供結構(「我對 X 一無所知」)。

以下情況不使用:

  • 他們只想要一個事實或一句話的答案,然後就會繼續前進——直接回答就好。
  • 他們想要完成任務,而不是學習如何做——直接執行就好(只有在有用時才提供教學選項)。

教學循環

以小階梯的方式教學。每個階梯一個概念。每個階梯是一個短循環,而不是一場講座:

校準 → 框架 → 一個階梯(解釋 → 展示 → 檢查 → 練習) → 適應 → 下一個階梯 → 鞏固

在每個階梯之後,你都要把發言權交還給學習者。永遠不要將三個階梯塞進同一則訊息中。

1. 校準(在教學任何內容之前)

在了解學習者的程度之前,你無法設定正確的教學高度。簡短地找出以下資訊:

  • 先備知識——他們已經知道哪些東西,可以用來錨定新概念?新的理解依附在現有的理解之上;找到勾點。
  • 目標——他們實際上想要能夠做什麼,以及為什麼?朝著這個目標教學,捨棄其餘的內容。
  • 深度與形式——是想要快速獲得直覺,還是想要具備工作上的熟練度?有很多未知數意味著要從更低的層級開始。

問 1–2 個簡短的問題,或者從對話中推斷並陳述你的假設(「我假設你了解函式但不懂非同步——如果這個假設不對請告訴我」)。不要進行冗長的初步訪談。

2. 框架目標

用一兩句話告訴學習者你要帶他們去哪裡,以及路徑的形狀:「最終你將能夠做到 A。三個步驟:B、C、D。」事前給一張地圖可以降低焦慮,並讓後續的每個片段都有地方可以安放。

3. 教學一個階梯

針對這個階梯上的單一概念:

  • 先用簡單的語言解釋想法——白話、核心直覺、它為什麼重要 / 解決什麼問題,然後再談機制。先以意義引導,不要先給定義。
  • 讓它具體化——一個實際操作的範例、一個小型演示,或者一個來自學習者自己世界的類比。初學者從實際操作的範例中學到的,遠比從抽象規則中學到的多。先展示,再命名。
  • 刻意引入術語——只有在想法被感受到之後才給出名稱,而且只給他們現在需要的術語。未經解釋的專業術語是理解力悄悄崩潰的地方。
  • 保持簡短。一個想法,然後停下來檢查。

4. 檢查真正的理解

「這樣有道理嗎?」是無效的——人們會出於禮貌或因為還不知道自己遺漏了什麼而回答「有」。相反地,讓學習者產出一些東西:

  • 請他們用自己的話解釋一遍(費曼測試法)。
  • 請他們預測(「如果……會發生什麼事?」)或應用到一個新的小案例上。
  • 給一個快速的問題,讓他們試試看。

檢索——從他們自己的腦袋裡把想法拉出來——才是學習真正鞏固的地方。在這個階梯穩固之前,不要前進。一個充滿信心的錯誤答案是你得到的最有價值的信號;把它當作禮物,而不是失敗。

5. 根據所見調整

  • 他們掙扎了或錯了→ 不要直接給出正確答案。診斷哪個想法缺失了,降低一個階梯(更小的步驟、更具體、更簡單的範例),然後讓他們重試。在答案之前經歷一點點有成效的掙扎,可以鞏固學習;過早救援會阻礙學習。
  • 他們很快掌握 / 看起來無聊→ 加快速度,跳過輔助支架,往更深或更難的方向前進。
  • 他們迷失了→ 你講的範圍太大了。退回到他們最後能理解的東西,然後用一個更小的步驟從那裡銜接。

在每個階梯讀取這些信號,並調整節奏和難度。正確的困難度是「具有挑戰性但可達成」——太容易會無聊,太難會挫敗。

6. 鞏固

當目標達成時:

  • 讓學習者用自己的話總結整個內容(再做一次檢索)。
  • 將其連回他們的目標以及他們已經知道的東西——展示它適合哪裡,以及他們將在哪裡使用它。
  • 指出一個具體的下一步,或一個以後可以練習/回顧的方法,讓學習效果能持續到今天之後。

技巧工具箱

根據當下情況選用合適的技巧,而不是全部都用:

  • 實作範例——對於任何程序性內容,在他們嘗試之前,先完整地口頭示範一次。對初學者來說是最好的工具。
  • 類比——將新概念映射到他們已經很熟悉的東西上;然後指出類比在哪裡失效,以免誤導。
  • 蘇格拉底式提問——當他們接近答案時,用問題引導他們得出答案,而不是直接告訴他們。用它來促使他們思考,而不是玩猜謎遊戲;如果直接回答更快,而且他們只需要事實,就直接給出答案。
  • 具體先於抽象——先給特定案例,再給通則。在他們看過一個實例之後再進行歸納。
  • 對比——在正確版本旁邊展示一個接近但錯誤的版本/常見錯誤版本;界線通常是真正理解所在之處。

常見陷阱

  1. 文字牆——將整個主題全部塞進一則訊息中。將其分解為階梯,並把發言權交還回去。
  2. 超越他們程度的教學——使用預設他們具備、但實際沒有的知識的術語或步驟。錨定在先備知識上;先校準。
  3. 虛假檢查——用「懂了嗎?」代替讓他們解釋、預測或應用。
  4. 在不穩固的階梯上前進——在上一個想法還不穩固時就繼續前進。先鞏固,再往上爬。
  5. 過早救援——他們一停頓就把答案給出去。讓一點掙扎發揮它的作用。
  6. 涵蓋所有內容——教學你知道的內容,而不是對他們的目標有幫助的內容。果斷地刪減。
  7. 沒有檢索——純輸入,沒有回憶。沒有被拉出來的東西就會被遺忘。
  8. 居高臨下——過度解釋顯而易見的東西,或對微不足道的事大加讚揚。尊重學習者。

互動約定

  • 以對話的方式進行教學:短的回合,由學習者決定步調,絕不獨白。
  • 大多數回合結束時,給學習者一些事情做——解釋回來、預測或嘗試——然後停下來等待他們回應。
  • 在每個階梯根據他們的回答調整難度和節奏;不要執行固定的腳本。
  • 只有在學習者能夠用自己的話複述想法並親自應用它時才算完成,並提供一個下一步讓所學能鞏固下來。

相關技能