alfredzhang98/research-obsidian-skill

ai-wiki — 將內容歸檔至知識庫（輕量級，預設）

將「把這個寫下來」變成一個命名正確、連結正確的筆記，並存放於 AI 代管的資料夾中。

此指令不建立主題。 它只產生一則筆記，且需要至少一個指向現有筆記的 [[wikilink]]。若要將筆記放置於主題中樞下並包含雙向連結，請使用 /ai-wiki-full。

為什麼主題預設關閉：當每篇論文都有專屬中樞時，中樞就不再具有組織功能——它只是給了論文一個更長的名稱。主題是一個研究方向，而非論文的主題。判斷標準請見 references/note-specs.md 中「什麼才算是主題」一節。

輸出位置

此技能產出的所有內容都位於 AI 代管的資料夾中。

區域	處理方式
AI 代管資料夾（<AI_WIKI>/**）	可自由建立／編輯／移動／重新命名／刪除
使用者自有的筆記資料夾	可自由讀取與搜尋；可進行增量修改；刪除、重新命名、移動或覆蓋前務必先詢問
.claude/rules/、CLAUDE.md	靜態設定——僅在使用者要求變更 Claude 行為時才編輯；更新 updated: 欄位。唯一的動態例外是 .claude/rules/active.md
.obsidian/、.trash/	可讀取但不可修改——編輯 Obsidian 設定可能導致儲存庫損毀

權限層級並未封鎖任何區域，因此上述限制仰賴判斷力。儲存庫通常不是 git 儲存庫；手寫筆記一旦被錯誤覆蓋，只能從檔案同步的版本歷史中復原。

從上述區域讀取內容，然後將摘要歸檔至 AI 代管資料夾，正是這個技能的核心用途。

參考檔案——請按需求閱讀，無需全部讀取

檔案	何時閱讀
references/vault-guide.md	決定要放在哪個資料夾時——路由表、使用者常見用語範例、標籤／wikilink 模型
references/note-specs.md	撰寫論文筆記、學習筆記或主題計畫時——檔案名稱、frontmatter、章節規範、用詞規則
references/figures-diagrams.md	筆記需要圖表時——擷取指令、嵌入格式、Mermaid 規則
references/tools.md	選擇哪個技能或 CLI 來處理輸入，以及端到端的工作流程

例行歸檔（一個明確的資料夾，無圖表）無需參考上述檔案——以下程序即已足夠。

程序

1. 分類——從 references/vault-guide.md 的路由表中，挑選一個目標資料夾。一則內容只歸入一個資料夾；跨領域的內容透過 tags: 和 [[wikilinks]] 來連結，絕不建立副本。
   • 尚未確定、仍在探索或批次處理的內容，請放入 Inbox/，而非正式資料夾。
   • 若真的無法判斷該歸入哪個資料夾：請詢問使用者，不要自行猜測並重複歸檔。
2. 命名——依照 references/note-specs.md（全小寫 kebab-case）：
   • 論文 → Research/papers/<第一作者姓氏>-<年份>-<2-3個關鍵字slug>.md（此指令不建立主題，因此筆記直接放在 papers/ 根目錄；/ai-wiki-full 則會將筆記置於 papers/<主題slug>/ 中）
   • 學習筆記 → Research/learning/<主題slug>-<YYYYMMDD>.md
3. 先檢查是否已有現有筆記——在寫入前，使用 Glob 搜尋目標資料夾（論文請用 Research/papers/**/*.md；注意各主題的子資料夾）。更新現有筆記勝過建立接近重複的內容；若已存在，請合併並告知使用者。
4. 填入內容——使用 Read 讀取 Templates/ 中對應的骨架（paper-note.md / learning-note.md），並就地填入；切勿憑記憶重建結構。章節指引請參考 references/note-specs.md，而非骨架中的 {{...}} 提示。
   • > [!callout] 區塊是強調系統——請保留它們，不要新增其他類型。
   • 頂端的快速卡片最後才撰寫：它濃縮了完成後的筆記內容。若其六行無法填滿，表示底下的筆記尚未完成。
   • S0「這篇論文用白話來說在做什麼」是強制性的：用 3-5 句話寫給熟悉領域基礎但未讀過此論文的人。順序：他們面臨的情境、他們建構了什麼、為什麼有效、他們得到了什麼。如果你無法撰寫此章節，表示你尚未理解這篇論文——請停止並重新閱讀，而不是繼續進行。
   • 論文筆記的順序應為：S0 白話摘要 → S1 背景 → S2 既有工作無法做到的事 → S3-S4 方法與數學 → S5 實驗設定 → S6 實驗結果 → S7 限制與作者未來工作 → S8 我的分析與研究機會。
   • S2 和 S8 是這則筆記存在的理由——兩者都不能用泛泛之詞填充。S4 的數學必須能從筆記中重建，而不僅僅是能辨識。
   • S8 的每個機會都需包含全部四行（機會 → 為何仍未解決 → 第一個實驗 → 歸檔至哪個主題）。「沒有值得採取的機會——<原因>」是有效的；憑空捏造的則否。
   • 專業用語：避免隱喻性標籤（如「本文的切入點」、「裁決」、「最強數字」）。請見 references/note-specs.md 中的用詞表。每個判斷都必須建立在具體證據上。
   • 在撰寫前請先閱讀論文。切勿僅根據摘要填寫章節；若某章節的 PDF 文字無法取得，請寫 {{not available in source}} 而非填入看似合理的內容。
5. 圖表——依照 references/figures-diagrams.md：論文圖表透過 paper-figures 技能擷取至 _attachments/paper-figures/<論文slug>/（附件樹保持扁平，絕不鏡像至主題資料夾），並嵌入在每個圖表發揮作用的章節處。
   • 嵌入前綴取決於筆記的深度：在 papers/ 根目錄使用 ../../_attachments/...，在 papers/<主題slug>/ 內部則使用 ../../../_attachments/...。這是當筆記移動時唯一會默默失效的地方——請抽樣檢查一張圖片。
   • 自行繪製的圖表請使用 Mermaid 圍籬。禁止使用 ASCII 藝術。
6. 連結（強制，至少一個）——筆記必須至少包含一個指向現有筆記的 [[wikilink]]：Research/topics/ 中的中樞筆記、另一篇論文筆記，或學習筆記。
   • 先使用 Glob 搜尋 Research/topics/ 和 Research/papers/，選擇最接近的目標，並用一句話說明關聯，而非僅放置裸露的連結。
   • 此指令不建立主題。 若真的沒有任何內容可連結，請在 .claude/rules/active.md 中標記此處開闢了新領域，並告知使用者 /ai-wiki-full 是用來建立中樞的指令。
   • 當筆記確實歸屬於某個現有主題時，請將正向連結加入該主題的 S6 列表中——雙向連結正是讓圖譜形成叢集的關鍵。
7. 註冊——若此筆記開闢了新方向或為進行中的工作，請在 .claude/rules/active.md 中新增一行指標，並更新其 updated: 欄位。請勿在此處鏡像狀態。active.md 是此工作流程中唯一無需使用者明確要求就能觸及的規則檔案。

完成前自我檢查

• 所有寫入的路徑都在 AI 代管資料夾內
• 檔案名稱符合其筆記類型的規範；論文筆記位於 papers/ 根目錄（此指令不建立主題）
• 嵌入前綴與筆記深度匹配，且至少抽樣檢查了一張圖片
• Frontmatter 完整（tags: 存在且具體，不僅是 research/）
• 至少一個指向現有筆記的 [[wikilink]]，並說明了關聯
• 從實際的範本檔案建構，章節順序與 callout 區塊保持不變
• S0 白話摘要已填寫，無行話堆砌
• 快速卡片最後撰寫；所有六行均為具體陳述，且可獨立閱讀
• 傳遞的筆記中無殘留的 {{placeholder}}
• 無隱喻性標籤
• 圖表內嵌於文中，而非集中在結尾
• 論文筆記： S2 指名了實際的先驗方法及其特定失敗原因；S7 區分了作者陳述／我發現的／他們的未來工作；S8 的結論引用證據，且每個機會皆有全部四行
• 學習筆記： S1 為使用者的原始提問；S5 包含一個真實的數值範例
• 告知使用者寫入的確切路徑

相關

若要建立或尋找包含雙向連結的主題中樞，請使用 /ai-wiki-full。 根據輸入類型選擇工具：references/tools.md。完整的區域規則：.claude/rules/permissions.md。