tutor-setup

tutor-setup 技能總覽

tutor-setup 的用途

tutor-setup 會把學習素材或程式碼庫整理成一個 Obsidian StudyVault。它不是只給你一份原始摘要，而是為了想要有結構的學習工作區的人而設計：這個 skill 可以建立筆記、萃取來源內容，並加入偏向練習導向的組織方式。

最適合哪些人

如果你需要一種可重複的方法，把 PDF、網頁、文字檔，或一個原始 repository 轉成可用的學習或 onboarding vault，就很適合使用 tutor-setup skill。它特別適合自學者、講師，以及想要輕量知識庫、而不是一次性答案的團隊。

它的差異在哪裡

它的主要價值在於具備情境感知的設定能力。tutor-setup 會自動偵測目前資料夾是文件來源還是 code project，接著調整工作流程。這讓 tutor-setup for Skill Scaffolding 在你想用同一個 skill 處理兩種常見輸入型態、又不想每次手動重寫流程時特別有用。

如何使用 tutor-setup skill

安裝並把檔案放對位置

先在你的 skill 環境中執行安裝指令，然後在目前工作目錄內操作，因為 tutor-setup 會嚴格限制在 CWD 邊界內。tutor-setup 的安裝流程仰賴先把來源檔案複製到工作資料夾中；它不會跨出那個邊界去抓取檔案。

提供正確類型的輸入

tutor-setup 的使用方式很單純：提供本機來源路徑或 URL，然後讓 skill 自行判定模式。要得到最佳結果，請把你要的成果講清楚，例如：「把這些 lecture notes 轉成一個 Obsidian StudyVault，包含章節摘要和練習題」，或是「從這個 repo 建立一個給新開發者使用的 onboarding vault」。

先閱讀這些檔案

先看 SKILL.md，因為它定義了模式偵測規則、CWD 邊界，以及兩種工作流程。如果你的複本裡有 references/templates.md 和任何相關說明，也要一起檢查，這樣在要求輸出之前，你就能先了解預期的 vault 結構。在 repository 情境下，也請掃過 README.md、AGENTS.md，以及任何存在的 rules/、resources/、references/ 或 scripts/ 資料夾。

會影響輸出品質的提示技巧

一開始就講清楚來源類型、目標受眾和深度。像「對這個資料夾使用 tutor-setup」這種弱提示，會留下太多猜測空間；更強的提示會直接說明 vault 應該優化什麼，例如考試準備、onboarding 或快速複習。如果你是把 tutor-setup 用在 Skill Scaffolding，也要把你想要的輸出形式、筆記顆粒度，以及對術語、語氣或檔名的限制一併寫清楚。

tutor-setup skill 常見問題

tutor-setup 比一般提示詞更好嗎？

當你想要一個可重複、邊界更清楚、模式選擇更明確的工作流程時，答案是肯定的。一般提示詞可以摘要內容，但 tutor-setup 會把文件探索、來源處理與 vault 建立的流程講得更明確。

什麼情況下不該用 tutor-setup？

如果你的來源檔案不在目前工作目錄內，而且你又沒辦法先把它們複製進來，就不該用它。若你只想要一個簡短答案，它也不太適合，因為這個 skill 的目標是產出結構化的 StudyVault，而不是快速解釋。

tutor-setup 適合新手嗎？

可以，只要你能指定一個資料夾，並描述你想要的學習成果。新手最常遇到的風險是輸入太模糊；這個 skill 最適合在你明確指出要的是學習筆記、練習題，還是開發者 onboarding vault 時使用。

tutor-setup 同時支援文件和程式碼嗎？

可以。這正是它的核心優勢之一：tutor-setup 會根據 CWD 的內容，自動判定是 Document Mode 還是 Codebase Mode。如果資料夾本身有歧義，就在提示詞中直接確認模式，讓流程保持和你的意圖一致。

如何改進 tutor-setup skill

提供更乾淨的來源素材

最強的 tutor-setup 輸出，來自範圍清楚的輸入：一個資料夾、明確的來源集合，以及容易分類的檔案。如果素材本身很雜、混在一起，或有重複內容，vault 通常也會跟著繼承這些混亂。

指定最終用途，不要只講來源

請直接告訴 tutor-setup 這個 vault 是拿來做什麼的：考試複習、概念記憶、團隊 onboarding，或專案上手。這個選擇會影響筆記裡哪些內容被強調、哪些章節該寫得更細，以及練習題要怎麼出題。

先檢查第一版 vault 有沒有模式判定錯誤

最常見的失敗模式，是模式選錯或結構過於泛化。如果第一版感覺不對，就把提示詞收緊：直接點名來源類型、確認模式，並在要求修訂前先指出最重要的資料夾或文件。

用有針對性的限制反覆微調

要把 tutor-setup 用得更好，與其整個重跑，不如直接要求具體修訂。例如：「降低筆記深度」、「增加更多練習題」、「聚焦 onboarding 術語」，或「把資訊密度高的主題拆成更小的學習筆記」。這樣可以在不破壞 skill 已經建立的結構下，讓輸出維持對齊。