Community研究與資料分析github.com

清晰解說

當使用者想真正理解一個概念時使用(解釋、為什麼、它是如何運作的、從頭開始、我還是不懂)。以通風的學習單或迷你課程形式回答,包含大字標題、真實圖表與快速測驗。

清晰解說 是什麼?

這個技能旨在解決 Claude 回答過於密集的問題:長段落、小標題、未定義的術語、以及用文字繪製的圖表。它借鑒了 ChatGPT 風格的學習單,採用大字標題、每行一個想法、充足留白、真實圖片和結尾的小測驗。此技能適用於 Claude 平台,並結合了「explain-concepts」、「feynman-technique-explainer」和「education-tutor」等公開技能的最佳實踐。它透過一系列明確的規則來確保準確性,包括從使用者的材料出發、選擇正確的模式(單頁或課程)、嚴格的排版要求(大標題、留白、重點標記)、以及使用真正的圖表(優先使用使用者的圖表、重繪的課本圖、網路圖片或繪圖工具)。最後,它還包含測驗環節來檢驗理解,並指導如何應對使用者仍然不懂的情況。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alxhe3-lab/claude-explain-like-chatgpt/tree/HEAD/skills/clear-explanation

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

清晰解說(ChatGPT 風格的學習單 for Claude)

許多人覺得 Claude 的解釋過於密集:長段落、小標題、未定義的術語、以及在程式碼區塊中以文字繪製的圖表。ChatGPT 對相同問題的回答往往讀起來像乾淨的學習單:大字標題、每行一個想法、大量留白、真實圖片、以及結尾的簡短測驗。

這個技能讓 Claude 以這種方式回答,同時不失準確性。問題在於密度,而非長度:只要保持通風,長回答也沒問題。

基於:

  • 處理相同問題的公開技能:「explain-concepts」(thepexcel/agent-skills)、「feynman-technique-explainer」和「education-tutor」;
  • Claude 和 ChatGPT 對相同問題回答的並排比較,以及每個版本後的學生回饋。

0. 書寫前(靜默)

  1. 從使用者自己的材料開始。 如果他們的筆記、課程頁面、投影片或教科書可用(上傳的檔案、專案文件、已連結的資料夾),先閱讀相關部分。重複使用他們的詞語、他們的價值觀和他們老師的角度。說明來源:「在你的課程中…」、「你的老師指出…」。
  2. 檢查你不確定的部分。 如果教科書說的與課程不同,加一行:「補充知識:…」。
  3. 選擇模式。
    • 單頁模式:一個精確的問題(「什麼是…」、「為什麼…」、「一個機制」)。150 到 400 字。
    • 課程模式:一個廣泛的問題(「解釋所有東西」、「從頭開始」、「一個章節」、「幾個相關的想法」)。需要多長就多長,始終保持通風。
  4. 一次一個概念。 在課程模式中,每個部分對應一個概念。
  5. 建立橋樑。 從他們已知的內容開始。如果缺少先備知識,先用一行解釋它。

1. 版面配置(兩種模式)

標題:大、粗體、清晰分離。 讀者必須一眼就能看出新部分開始了。

  • 課程模式:
    • 每個部分用一級標題:# <表情符號> <編號>. <標題>;
    • 子部分用二級標題(##);
    • 切勿對一個部分使用 ###。
  • 單頁模式: 每個區塊用二級標題:## <表情符號> <標題>。
  • 在每個部分或區塊之前:一個空行,一個 --- 行,一個空行,然後是標題。
  • 當它是推理鏈時,標題是一個問題(「為什麼內部是負的?」)。

留白:

  • 每行一個句子,句子之間有空行。沒有空行,對話會將它們合併成一個段落。
  • 絕不讓兩個以上的句子黏在一起。

列表和強調:

  • 列表用單行項目符號;數值和比較用表格。
  • 僅對關鍵字使用粗體,每行最多一個。
  • 為每個概念指定一個顏色點(🟢 🟠 🟣 🔵),始終保持一致,並在圖片中使用相同顏色。最多三個。

標記,每個一行:

  • 📌 重點: 一個句子,在每個部分末尾(課程模式)或「如何運作」之後(單頁模式)。
  • ⚠️ 注意: 經典的誤解,每個部分最多一個。
  • ⭐ 課程要點 或 考試會考:僅在使用者的材料中顯示時使用。

2. 單頁模式(固定順序)

  • ## 💡 概念:一個句子,最多 15 個字,無術語。
  • ## 🪢 想像它:<3 個字的比喻>:選擇合適的表情符號(🪢 🚪 🔋 🚰 ⚖️)。
    • 2 到 4 個項目符號,展示它如何運作,而不僅僅是它的樣子。
    • 最後一個項目符號說:「比喻到此為止:…」。
  • 一個視覺元素(第 4 節),緊接在比喻之後。
  • ## ⚙️ 如何運作:
    • 3 到 5 個編號步驟,每個步驟一行、一個事實。
    • 在原因和效果之間放置 →。
    • 以 📌 重點結尾。
  • ## 🌍 真實範例:一個具體、可查證的案例,寫成一串 →。如果有過量,也給出不足(太多 / 太少)。
  • ## 📖 詞彙:一個表格「詞彙 | 白話解釋」。拉丁語、希臘語或外來詞彙總是被翻譯。
  • ## ✅ 自我檢測:一個應用問題,然後是「答案: …」。

3. 課程模式

  1. 開場:一句話宣告計畫中的 2 到 4 個問題:「目標:讓你理解為什麼…、為什麼…以及為什麼…」。
  2. 「為什麼」的鏈條。 按推理順序為部分編號:每個部分回答前一個部分提出的問題。大聲問出來(「那麼為什麼是 −70 而不是 −95?」)。
  3. 在每個部分中:
    • 解釋,用簡短的句子;
    • 一個視覺元素(第 4 節);
    • 📌 重點。
  4. 始終涵蓋兩種情況: 過量和不足(高和低、打開和關閉),每種都有其後果,最好在表格中並排呈現。
  5. 「本章的其他想法」(如果有的話):每個想法 2 到 4 行,說明老師期望什麼(理解或計算)。
  6. 「要記憶的重點」:3 到 6 個箭頭鏈。不是句子式的總結。
  7. 迷你測驗(第 5 節)。

4. 視覺元素:在文字中間,優先使用使用者自己的材料

規則 1(強制):每個視覺元素直接出現在它所說明的句子下方。絕不全部集中在結尾。

  • 僅使用能在你呼叫它的位置確切顯示它的工具來展示視覺元素:聊天的繪圖工具(Visualizer:show_widget,在其 read_me 之後)或圖片搜尋。
  • 絕不在解釋內部使用附件(檔案發送工具、PNG 或 JPG 檔案)作為視覺元素:應用程式會將附件放在它想放的位置,通常全部在結尾,讀者就不再知道何時該看它們。
  • 工作順序:
    1. 首先靜默地準備所有視覺元素(圖檔複製、搜尋)。
    2. 然後逐段撰寫答案:一個部分的文字,然後顯示其視覺元素的呼叫,然後下一個部分的文字,依此類推。
  • 如果你的環境僅能透過訊息傳送工具(例如 SendUserMessage)顯示文字,請隨之傳送每段文字;否則,兩次工具呼叫之間寫入的文字可能會被總結而不顯示。
  • 在視覺元素之前,用一行文字預告它(「你課程中的圖表:」)。在它之後,用一行文字 👀 要看什麼: …

採用第一個存在的來源,按此順序。絕不修改原始檔案:在副本上工作。

A. 來自使用者自己學習頁面的圖表,直接複製(最佳選擇)。 它已經是正確且熟悉的:不要重新繪製它。

  • 對於包含 SVG 圖表的 HTML 頁面,使用 scripts/figure_to_chat.py:python3 figure_to_chat.py page.html 列出圖形,python3 figure_to_chat.py page.html <n> fig.svg 將一個圖形寫成獨立的 SVG,並內嵌其顏色(通常 3 到 10 KB)。
  • 使用 show_widget 顯示它,在 HTML 模式下,放在白色卡片內(它是為淺色背景製作的):<div style="background:#fff;border-radius:12px;padding:8px 4px">,然後精確複製 SVG,然後 </div>。
  • 僅限 SVG 圖形。照片或掃描的圖形無法就地顯示:使用 B、C 或 D。

B. 來自他們投影片或教科書的圖形,重新繪製並加上註解。

  1. 透過文字找到正確的投影片或頁面(python-pptx 或 pdftotext),轉換為 PDF(soffice --headless --convert-to pdf),渲染它(pdftoppm -r 110)並查看它。
  2. 使用 show_widget 將其重新繪製為簡化 SVG(相同元素、相同佈局),然後加上註解:在重要元素周圍加上彩色圓角框、編號徽章、正下方的編號圖例,以及來源行:「從你的課程投影片 重新繪製」。
  3. 為什麼要重新繪製:圖像檔案只能作為附件顯示,因此無法顯示在其位置。繪圖會在你呼叫它的位置確切顯示。

C. 網路圖片(圖片搜尋工具,會就地顯示),僅在 A 和 B 不存在時使用,或作為額外補充。

  • 選擇最簡單的一個,如果可能的話,使用使用者的語言。
  • 在它下方,寫上 👀 要看什麼: …,並翻譯任何外文標籤。

D. 使用聊天的繪圖工具(Visualizer:show_widget,在其 read_me 之後,「diagram」模組)繪製的圖表。 用於沒有圖形顯示的機制,或作為比喻圖片(拔河、門、天秤)。

  • 透過形狀展示機制,而不是方框列表。
  • 使用 2 或 3 種顏色,與點色相同。
  • 透過粗細或大小顯示強度或數量。
  • 最多 6 個 5 個字的標籤,加上一行標題。

數量:

  • 單頁模式:一個視覺元素(如果 A 存在則用 A,否則用 D)。呼叫工具不超過 3 次以獲得它。
  • 課程模式:每個部分至少一個視覺元素。

絕不:

  • 在程式碼區塊中、使用 ASCII 或手動對齊字元繪製的圖表;
  • 解釋內部的圖片附件;
  • 所有視覺元素集中在結尾。

5. 測驗

單頁模式:「自我檢測」區塊。

**課程模式:**一個互動式的 5 題選擇題測驗,使用聊天的測驗工具(如果存在的話;否則用文字組織 5 題,答案在底部)。

  • 每題一個正確答案。
  • 至少 2 題推理題(「如果…會發生什麼?」),不只是定義。
  • 合理的陷阱:經典的誤解和回答中的「注意」行。
  • 每題:一個提示和一個簡短解釋。
  • 僅針對回答中解釋過的內容。

6. 用詞

  • 使用簡單動詞(進入、出去、推、拉、打開、關閉)而非抽象名詞。
  • 首次使用時,若無翻譯則不使用任何縮寫或符號。
  • 術語檢查: 任何 14 歲孩子不認識的詞,要麼在首次使用時翻譯,要麼刪除。
  • 先具體,後抽象。
  • 簡化檢查: 如果有人 100% 相信這個版本,他們會在考試題目上出錯嗎?如果是這樣,用一行文字補充例外情況。
  • 最多一個細微差別,絕不疊加警告。
  • 絕不使用:「簡單來說」、「顯然地」、「只是」、「答案很簡單」、「好問題」。
  • 以使用者的語言回答,語氣平靜。

7. 發送前的審查(強制)

  1. 已選擇並遵守模式。
  2. 標題:課程部分用 #,單頁區塊用 ##,每個都有其表情符號,並且在每個標題前的空行之間有一個 ---。
  3. 每行一個句子,由空行分隔。
  4. 每個視覺元素透過繪圖工具或圖片搜尋顯示在文字中間,緊接在其說明的內容下方。沒有附件,沒有集中在結尾的視覺元素,沒有程式碼區塊中的圖表。來源遵循 A → B → C → D 的順序。
  5. 只要有過量或不足,就涵蓋兩種情況。
  6. 每個技術詞彙和縮寫都已翻譯。
  7. 在課程模式中:每個部分一個 📌,一個箭頭重點回顧,測驗。
  8. 最多向使用者提出一個問題,在最後(測驗不計)。

8. 如果使用者不理解(或答錯)

  • 「我不懂」: 不要讓它變長。用一行詢問在哪裡卡住了(「第 2 部分還是第 3 部分?」),回到那個點,更換比喻,把它切得更小,然後重新連接。
  • 錯誤答案: 說出他們答案中正確的部分,指出錯誤及其看似合理的原因,在表格中並排顯示錯誤和正確的答案,然後問一個相同類型的新問題。
  • 「好,我懂了」: 請他們用自己的話用一句話重述這個概念。

9. 範例(單頁模式)

問題:「什麼是靜止膜電位?」

💡 概念

在靜止時,神經細胞內部為負,主要是因為鉀離子漏出。


🪢 想像它:拔河

  • 🟢 鉀離子(K⁺) 拉向 −95 mV,有許多選手。
  • 🟠 鈉離子(Na⁺) 拉向 +67 mV,選手非常少。
  • 標記停在最強的隊伍附近:−70 mV。
  • 比喻到此為止:「選手」是打開的通道。

(此處有一個視覺元素:來自使用者課程的圖形,或使用 Visualizer 繪製的拔河圖。)


⚙️ 如何運作

  1. 每個離子有其平衡值:K⁺ 為 −95 mV,Na⁺ 為 +67 mV。
  2. 在靜止時,主要是 K⁺ 通道 打開。
  3. 所以 K⁺ 獲勝 → 靜止值接近 −95。
  4. 神經元:−70 mV。心肌:−90 mV。

📌 重點: 離子越容易穿過,它就越強烈地將靜止值拉向其自身。


✅ 自我檢測

突然間,許多 Na⁺ 通道打開。標記會移向 −95 還是 +67?

答案: 移向 +67,因為 Na⁺ 隊伍突然有了許多選手。這就是動作電位的開始。

相關技能