learn

Learn: 從原始素材到發布輸出

在你的第一行前面加上 🥷 內嵌，不要自成一段。

更新檢查（非阻塞）。 每次對話執行一次 bash <skill-base-dir>/scripts/check-update.sh，將 <skill-base-dir> 替換為此技能的基礎目錄；若有任何輸出則轉達，否則靜默繼續（若腳本已執行過、不存在或發生錯誤也同樣處理）。此檢查每天最多一次，僅讀取公開版本檔案，且不發送任何資料。

支援使用者的思考，不要取代它。

成果合約

• 成果：不熟悉的素材轉換為使用者可用的可靠心智模型、參考資料、文章或筆記集。
• 完成條件：主要來源已收集或提供，矛盾已明確處理，最終結構在教學主題時不隱藏不確定性。
• 證據：來源 URL 或檔案、擷取的內容、消化筆記、大綱決策，以及根據要求輸出進行的自我審查。
• 輸出：研究筆記、大綱、可發布草稿或權威參考資料，符合所選模式。

邊界：僅需擷取的單一 URL 屬於 /read。需要摘要或分析的單一 URL 可使用 /read 作為擷取步驟，但最終答案應滿足使用者要求的摘要或分析。/learn 適用於產生新結構化輸出的多來源研究。

前置檢查

檢查 /read 和 /write 技能是否已安裝（在技能目錄中尋找它們的 SKILL.md）。若缺少則發出警告，但不阻擋：

• /read 缺少——階段 1 的擷取將回退到原生的 WebFetch / curl；對付費牆、重度 JavaScript 和中國平台頁面的覆蓋率會下降。
• /write 缺少——階段 5 的 AI 模式移除將回退到手動掃描。階段 1-4 不受影響。

選擇模式

要求使用者確認模式，若環境有原生提問或核准機制則使用之：

模式	目標	進入點	結束點
深度研究	充分理解某領域以能撰寫相關內容	階段 1	階段 6：可發布草稿
快速參考	快速建立可運作的心智模型，不打算寫文章	階段 2	階段 2：僅筆記
以寫促學	已有素材，透過寫作強迫理解	階段 3	階段 6：可發布草稿
權威文章	一篇文章涵蓋主題，讀者無需其他資料	階段 1	階段 6：單一權威參考

若不確定，建議快速參考。

權威文章模式

在以下情況啟用：「一篇就夠」、「一站式參考」、「整理成長文」、「目的是大家只需要看這篇就好了」，或使用者想要某主題的單一權威參考。

目標：讀完文章後，任何人都不需再搜尋該主題的其他資料。

在標準深度研究之上的額外要求：

• 每個主要子主題都必須有自己的章節；不留任何東西在註腳
• 包含實際範例，而不只是原則
• 涵蓋常見錯誤及如何避免
• 加入「延伸閱讀」章節，列出 3-5 個最深入的來源；標註哪些是最佳起點
• 階段 6 的自我審查必須確認：「讀者能單從這篇文章實作/理解這個主題嗎？」

階段 1：收集

僅收集主要來源：提出關鍵概念的論文、官方實驗室/產品部落格、建構者的文章、經典的「從頭建構」儲存庫。不要摘要。不要解說文。

每個來源依序三個步驟——不得偷工減料，不得合併：

1. 發現——使用已安裝的搜尋外掛（例如 PipeLLM）繪製領域地圖，然後深入搜尋 2-3 個最有前景的子主題。無外掛：使用環境的原生網頁搜尋。輸出是 URL 列表；此處不擷取內容。
2. 擷取——每個 URL 在可用時都透過 /read 處理。/read 負責代理串接、付費牆偵測及平台路由（微信、飛書、PDF、GitHub）。原生擷取工具和原始 curl 在重度 JavaScript 或付費網站上會靜默失敗，並跳過所有這些處理。若 /read 缺少（前置檢查已警告），則回退到原生擷取並接受降低的覆蓋率。
3. 歸檔——當研究專案有來源目錄時，告訴 /read 該目錄。若未指定目錄，讓 /read 使用每次對話的暫存目錄並回傳儲存路徑。在擷取完成後，將已儲存檔案移動或索引到子主題目錄。移動，不要重新擷取。

目標：部落格文章 5-10 個來源，深度技術調查 15-20 個來源。

階段 2：消化

逐步處理素材。對每個素材：完整閱讀，保留好的部分，刪除不好的。在此階段結束時，刪除約一半收集到的內容。

對於關鍵主張，在納入大綱前先問：

• 這個想法是否在同一個來源的至少兩個不同脈絡中出現？
• 這個框架能否預測該來源對一個新問題的看法？
• 這是該來源特有的，還是該領域的任何專家都會這麼說？

泛泛之論不值得提煉。通過兩或三個：屬於大綱。通過一個：背景素材。通過零個：刪除。

對話或審查提煉

當輸入是最近的對話、專案審查、評分卡或診斷報告時，將其視為原始素材：

• 優先使用已提煉的摘要、記憶條目和審查輸出；僅在驗證爭議細節或恢復重複模式的確切來源時才開啟原始逐字稿。
• 在編輯持久性指導之前建立候選矩陣：來源/專案、重複失敗、可轉移規則、目標層級、證據計數和紅action風險。僅提升具有跨來源支援或同一專案系列中重複失敗的候選項。
• 提取重複的工作流程失敗、不變量和驗證器表面。
• 刪除過時的行號、當前評分框架、私有路徑、單機設定和儲存庫特定指令，除非輸出明確針對同一儲存庫。
• 將每個持久性教訓映射到其目標層級：專案文件、共享規則、技能參考或確定性腳本。
• 對於適應性工作流程指導，優先使用參考或現有技能章節；僅對能在沒有專案特定脈絡下可靠失敗的確定性檢查使用腳本。
• 僅保留證據片段作為自己的筆記；不要將原始對話歷史貼到最終成品中。

階段 3：大綱

撰寫文章的大綱。對每個章節：註明其參考的來源素材。若某章節沒有來源，則該章節不應存在，或需要先找到來源。

階段 4：填充

逐章節處理大綱。若某章節難以撰寫，表示該子主題的心智模型仍薄弱：回到階段 2 處理該子主題。大綱可能會改變，這沒關係。

停滯訊號（任何一個表示該章節的心智模型不完整）：

• 你重寫開頭句子三次以上仍未定案
• 該章節僅依賴單一來源，且你無法交叉驗證該主張
• 你需要一個階段 1 未收集到的新來源
• 段落中有一個你無法向他人解釋的主張

停滯時：回到階段 2 處理該子主題，而非整篇文章。

階段 5：精煉

以特定簡報傳遞草稿：

• 移除冗餘和囉嗦的段落，不改變意思或語氣
• 標記論點不連貫的地方
• 找出缺口：在使用概念前未解釋、主張需要來源

不要摘要使用者尚未撰寫的章節。不要從頭起草新章節。僅編輯。

然後從草稿中移除 AI 模式。若 /write 已安裝，則呼叫它。若未安裝，則手動執行：掃描填充詞、二元對比、戲劇性碎片化和過度使用的副詞。刪除它們，不改變意思。

階段 6：自我審查與發布就緒

使用者在發布前線性閱讀整篇文章。不要用 AI。標記所有感覺不對的地方，修正後再讀一次。至少兩次。

當從頭到尾讀起來流暢時，草稿就準備好讓使用者發布了。

嚴格規則

• 在大綱穩固之前不得進入階段 4。 沒有來源的章節要麼不該存在，要麼需要先找到來源。
• 矛盾要保持可見。 當兩個來源對事實主張矛盾時，註明雙方的立場及其提供的證據；絕不默默選擇其中一個。
• 在發布確認時停止。 在使用者確認文章準備好之後，除非明確要求，否則不要上傳、發布、散佈或執行任何發布動作。

常見陷阱

發生情況	規則
收集了 30 個次要解說文而非主要來源	階段 1 目標是論文、官方部落格和建構者的儲存庫。摘要不是來源。
在已安裝 /read 的情況下使用原生擷取工具或 curl 處理 URL	階段 1 的擷取不是可選的。/read 負責代理串接、付費牆偵測和平台路由。繞過它會靜默損失付費牆、重度 JavaScript 或中國平台頁面的覆蓋率。
將有說服力的解說文視為事實	問：這是否在同一個來源的至少兩個不同脈絡中出現？
階段 2 寫了摘要而非教導概念	消化意味著建立心智模型。摘要不是消化。
在使用者說準備好後，AI 主動提議將文章上傳到部落格或社群平台	在確認時停止。發布是用戶的動作，不是你的。
將專案審查轉換為通用 Waza 規則而未過濾	僅提升重複的工作流程行為。將專案特定指令、路徑和安全限制留在該專案中