name: knowledge-teaching description: "Use this skill for any request to learn, teach, or explain a topic in depth — 生成系統化、全面、事實準確的深度知識教學文章/教程,不限領域(程式設計、數學、科學、人文社科)。使用者想'真正學懂'某個知識時就該用:'幫我講講 X''寫一篇 X 教程''系統學習 X''X 入門到精通''給小白科普 X''整理 X 的知識體系',即使沒提'教程'二字,只要是全面、系統、有深度的知識講解都觸發。特點:大綱先行的由淺入深結構、事實聯網核實+編號引用+存疑標註、統一美觀的 Markdown 排版,可匯出 Word/PDF(大綱導航+頁碼)。純執行類任務(寫個函式、寫郵件、翻譯、整理紀要)不觸發,除非使用者要求講解原理。Triggers: 教學文章, 教程, 科普, 系統學習, 知識講解, 入門到精通, tutorial, teaching article, explain in depth, 知識整理。" metadata: version: "1.1.0" status: stable

系統化知識教學文章生成器

把任意主題的知識寫成系統、全面、準確、美觀的教學文章。適合使用者想要「真正學懂一個知識」的場景:教程、科普、知識整理、系統學習筆記。

核心原則(四條鐵律)

1. 系統性:大綱先行,由淺入深

使用者抱怨 AI 內容「不繫統」的根源,是想到哪寫到哪。這個 skill 的做法:

• 動筆前先規劃知識大綱(章節樹);複雜主題(預計 4 章以上)先展示大綱讓使用者確認,再寫正文
• 內容按「直觀理解 → 核心概念 → 機制原理 → 實踐應用 → 進階」分層遞進
• 每講一個概念,立即跟上示例;概念之間要有邏輯銜接,不跳躍
• 文末給「知識地圖」:要點回顧 + 下一步該學什麼

2. 準確性:核實、引用、標註

使用者抱怨「知識點不真實」的根源,是模型憑記憶寫。這個 skill 的做法:

• 動筆前列出「待核實清單」:所有關鍵事實(數字、日期、專名、API、命令)用 WebSearch 核實
• 引用他人結論時標註來源 [1],文末附參考連結
• 核實不了的內容,明確標註「⚠️ 待核實」,絕不編造,並降低斷言語氣
• 技術文章示例必須可執行,標註環境/版本

詳見 references/fact-checking.md。

3. 全面性:講透,不注水

• 「全面」指覆蓋讀者學習路徑上需要的全部環節:前置知識、核心內容、常見誤區、練習——不是堆砌字數
• 每句話要有資訊量;寧願分章節展開,也不省略讀者會困惑的環節
• 邊緣情況、常見坑、FAQ 是「全面」的關鍵,不能省

4. 美觀:統一排版

• 嚴格遵循 references/formatting-guide.md 的排版規範
• 用 assets/article-template.md 作為結構骨架
• 輸出 Word/PDF 時用 scripts/convert.py,樣式自動套用

工作流程

第 1 步:快速澄清需求

只問必要資訊,資訊足夠就直接開始,不要問太多問題:

• 主題是什麼
• 讀者水平(預設:入門者;使用者說明了就給對應層次)
• 輸出格式(預設 Markdown 檔案;使用者要 Word/PDF 就做轉換)
• 深度偏好(預設:系統全面;使用者要求簡短就精簡)

第 2 步:規劃知識大綱

1. 讀 references/article-structure.md,瞭解教學文章的標準結構
2. 用 WebSearch 快速瀏覽該主題的權威資料,建立知識地圖(這也是核實的一部分)
3. 複雜主題(章節 >4):把大綱展示給使用者確認再寫;簡單主題直接寫
4. 大綱格式:章節樹 + 每章一句話說明要講什麼
5. 無人值守時不等待:在子代理/批次/自動化場景(無人可互動)下,直接按預設規劃繼續寫,不要停下等確認——在正文前註明「大綱已按預設規劃生成」即可

第 3 步:核實關鍵事實

按 references/fact-checking.md:

• 列出待核實清單 → WebSearch 核實(官方文件/權威來源優先)
• 寫作中發現任何不確定,立即停下來查,不要憑記憶寫
• 核實要聚焦:只搜尋「會寫進文章的關鍵斷言」,一次搜尋儘量覆蓋多項;不要對主題做漫遊式瀏覽(既費時又費 token)
• 技術文章必查版本與時效(特性引入版本、放寬/廢棄時間、資訊截止日期),見 fact-checking.md

網路不可用時(降級,不中斷):WebSearch 報錯、超時或返回空結果時:

• 換關鍵詞重試 1 次;仍失敗就進入降級模式,絕不讓整個任務因網路卡死
• 降級模式:繼續寫作,但所有未能聯網核實的斷言標「⚠️ 未能核實」,降低斷言語氣,不寫死數字/日期等硬事實(確實需要的,標註「以官方最新文件為準」)
• 文章開頭或結尾附一行「核實情況說明」:如實告訴讀者哪些內容已聯網核實、哪些沒有——絕不假裝核實過
• 交付時把核實情況轉告使用者,讓使用者知情,而不是讓使用者自己發現

第 4 步:撰寫正文

• 以 assets/article-template.md 為骨架
• 排版遵循 references/formatting-guide.md
• 邊寫邊標註引用 [1] 和「⚠️ 待核實」

第 5 步:輸出檔案

• 預設:寫到專案目錄,檔名用「主題名.md」(中文、簡潔)
• 先儲存 .md 再轉換:Markdown 檔案是交付底線,轉換永遠在 .md 落盤之後進行
• 使用者要 Word/PDF:執行轉換指令碼(見下)
• 轉換失敗不阻塞交付:指令碼報錯時,把指令碼列印的友好提示轉述給使用者(缺什麼依賴、怎麼裝、.docx 是否已生成),文章本身照常交付——不要讓使用者自己去翻 traceback

第 6 步:自我檢查(交付前必做)

• [ ] 結構完整:導語/學習目標/正文分層/示例/誤區/練習/總結/參考資料,缺一不可(簡單主題可省略練習與誤區)
• [ ] 每個概念:先直觀後嚴謹、有示例、術語首次出現有解釋
• [ ] 所有關鍵事實已核實或有標註;引用編號與文末列表一一對應
• [ ] 技術文章的版本/年代限定已對照核實(特性引入版本、放寬/廢棄時間、資訊截止日期)
• [ ] 程式碼示例可執行(本機有對應語言就執行驗證);格式規範(標題層級、語言標註、中英空格)
• [ ] 沒有注水段落;交付說明裡告訴使用者哪些點未核實到

輸出格式轉換(Word/PDF)

轉換指令碼 scripts/convert.py,需要 Python + python-docx(docx 模式);pdf 模式額外需要 pywin32 和本機 Word/WPS。

先探測 Python 環境,不要想當然:

# 按順序嘗試,找到能 import docx 的 Python 就用它:
python -c "import docx" 2>/dev/null && PY=python \
  || py -3 -c "import docx" 2>/dev/null && PY="py -3" \
  || PY="C:/Users/Hovekd/AppData/Local/Programs/Python/Python313/python.exe"  # 常見安裝路徑兜底

"$PY" scripts/convert.py docx 文章.md
"$PY" scripts/convert.py pdf  文章.md

• docx:Markdown 轉 Word,自動套用美觀樣式(中文字型、程式碼塊底紋、表格樣式、連結可點選)——不需要裝 Word
• pdf:先轉 Word 再呼叫本機 Word/WPS 匯出 PDF(保留全部樣式)
• 指令碼的所有失敗都有中文友好提示(缺依賴怎麼裝、沒有 Word/WPS 怎麼手動補救),把它轉述給使用者即可
• 轉換完成後告訴使用者檔案位置;失敗時告訴使用者 .md 和 .docx 在哪裡

常見情況

• 主題範圍 — 不限領域。技術、數學、科學、人文社科均可,流程相同。
• 使用者只想快速瞭解,不要長文 — 簡化結構:導語 + 核心概念 + 一個示例 + 總結,並在文末提示可擴充套件為完整教程。
• 查不到可靠資料 — 按 fact-checking.md 的「無法核實時的兜底」流程:標註待核實 + 說明檢索情況,讓使用者知情。
• 網路不可用/搜尋報錯 — 按第 3 步的降級流程:重試 1 次 → 標註「⚠️ 未能核實」繼續寫 → 附「核實情況說明」。絕不卡死、絕不假裝核實過。
• 轉換指令碼報錯 — 先確認 .md 已儲存,把指令碼的友好提示轉述給使用者(缺依賴/缺 Word 的補救方法),文章照常交付。
• 無人值守環境 — 大綱不等待確認,直接按預設規劃寫;核實與轉換的降級規則同樣適用。
• 不同平臺對 Markdown 支援不同 — formatting-guide.md 裡有平臺相容注意事項(知乎/公眾號/CSDN/GitHub)。

  7w4.net小蔥技能站收錄全網優質技能，值得收藏。

• 使用者指定了發表平臺 — 按該平臺的相容性調整(見 formatting-guide.md),並在交付時提醒差異。

這個 Skill 質量紮實，做知識講解和教程類內容很專業。它有一套完整的流程來保證文章既系統又有據可查，還會核實關鍵事實、標註文獻來源，輸出的文章排版也很美觀。內建的轉換指令碼可以把 Markdown 轉成 Word/PDF，失敗時也有友好的補救提示。不過它的觸發條件比較寬泛，可能什麼請求都會認為自己該響應；想把內容轉成 PDF 需要 Windows 系統，這些算是一點侷限。總體來說，用於寫教程、寫科普文章是靠譜的。