obsidian-bases
作者 kepanoobsidian-bases 可協助建立與編輯 Obsidian `.base` 檔案，支援篩選器、公式、摘要，以及表格、卡片、清單或地圖檢視。特別適合把筆記中繼資料轉成可實際運作的知識庫檢視，並可透過技能檔案提供的 YAML 驗證與函式參考指引，降低出錯機率。
這項技能獲得 82/100，屬於表現穩健的目錄條目：從 repository 證據來看，它提供了真實且可重複使用的流程，可建立與編輯含篩選器、公式及多種檢視類型的 Obsidian `.base` 檔案；同時也為代理提供足夠的 schema 與驗證指引，相較通用提示能明顯減少猜測。不過，目錄使用者仍應預期要在 Obsidian 內實際測試結果，因為這項技能偏重文件指引，並非由工具直接支援。
- 觸發條件明確：描述直接對應 Obsidian 中的 `.base` 檔案、Bases、表格／卡片檢視、篩選器與公式。
- 操作內容扎實：`SKILL.md` 提供具體工作流程、YAML schema 結構、驗證檢查方式，以及常見錯誤模式。
- 對代理很有幫助：內含的函式參考可實質協助代理建立公式，避免自行臆測語法。
- 沒有 install command 或可執行的輔助檔案；是否能順利採用，取決於是否閱讀並手動套用 markdown 指引。
- 驗證最終仍需在 Obsidian 中開啟 `.base` 檔案，因此在渲染或語法問題上，還是可能需要一些反覆嘗試。
obsidian-bases 技能總覽
obsidian-bases 擅長處理什麼
obsidian-bases 可協助代理建立與編輯 Obsidian 的 .base 檔案，用來產生類似資料庫的筆記檢視。當你需要可實際運作的 YAML，支援 Bases 的 filters、formulas、summaries，以及 table、cards、list、map 等檢視版型時，這個技能特別實用。
最適合 Knowledge Bases 工作流程的 obsidian-bases
這個 obsidian-bases 技能很適合把 vault 當成知識庫、專案追蹤器、閱讀清單或內容儀表板來管理的人。真正要解決的問題不是「幫我寫 YAML」，而是「把我的筆記與中繼資料整理成在 Obsidian 裡真的能正常顯示、能拿來用的檢視」。
為什麼要用 obsidian-bases，而不是一般提示詞
obsidian-bases 的差異在於結構化流程。這個技能會提供代理明確步驟：先用 filters 定義範圍，再加入可選的 formulas，接著設定檢視，最後驗證 YAML 與屬性參照。這能降低一般提示常見的失敗情況：.base 語法無效、公式參照失效，或檢視內容與 vault schema 不相符。
如何使用 obsidian-bases 技能
安裝情境與優先閱讀內容
這個技能本身沒有額外的安裝指令；它是 kepano/obsidian-skills 裡的指引型技能。請先從 skills/obsidian-bases/SKILL.md 開始，再讀 skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md。建議先看 workflow 段落，再看 schema 範例，最後只針對你實際需要的公式查閱 function reference。
obsidian-bases 技能需要哪些輸入
若想讓 obsidian-bases 發揮效果，請提供代理以下資訊：
- base 的目標，例如「顯示進行中的專案」
- 範例筆記路徑或資料夾
- 相關的 frontmatter properties、tags 與日期欄位
- 期望的檢視類型：
table、cards、list或map - 你需要的計算欄位，例如是否逾期或閱讀時間
- 顯示需求，例如屬性排序或 summary 欄位
弱輸入：「幫我做一個 task 用的 base。」
強輸入：「Create a .base file for notes in Projects/, include only notes where status != done, show title, status, due, and a formula is_overdue, default to table view, and add a cards view for mobile.`」
把模糊需求改寫成可用的 obsidian-bases 提示詞
實用的 obsidian-bases 提示，應要求輸出完整 .base 檔案，並附上驗證檢查。範例如下：
「Using obsidian-bases, create a valid .base YAML file for notes in Areas/Research/ tagged #paper. Add filters for only unread items from 2024 onward, define formulas for age_days and is_recent, create a table view ordered by title, author, year, and formula.age_days, and explain any quoting needed to avoid YAML errors.」
這樣的提示之所以更有效，是因為它明確指定了範圍、中繼資料、公式、顯示順序，並要求輸出時注意語法。
實際工作流程與輸出檢查重點
建議依照以下順序進行：
- 先要求最小可用的
.base。 - 在增加複雜度前先驗證 YAML 語法。
- 每次只新增一個公式。
- 第一個檢視能正常顯示後，再加入第二個檢視。
這個技能特別重要的品質檢查包括：
- 若字串含有 YAML 特殊字元，應加上引號避免解析失敗
- 凡是在檢視中使用到的
formula.X，都必須先在formulas內定義 - 確認 property 名稱與你的筆記完全一致
- 實際在 Obsidian 裡測試，不要只在文字編輯器中檢查
obsidian-bases 技能常見問題
obsidian-bases 適合新手嗎？
適合，前提是你已經理解 Obsidian 的基本 properties 與 frontmatter。obsidian-bases 技能比從零摸索整個格式更容易上手，因為它提供了相對安全的建立順序。不過如果你的 vault 中繼資料本身不一致，完全新手還是可能會卡關。
這和直接叫 AI 產生 .base 檔案有什麼不同？
一般提示詞可能產出看起來合理、但實際無法渲染的 YAML。obsidian-bases 更好的地方在於，它是圍繞真正的 .base 工作流程設計：先 filters，再 formulas，接著 views，最後才做驗證。當你需要處理公式時，它也會把你引導到對應的 function reference。
什麼情況下 obsidian-bases 不是對的工具？
如果你真正的問題是缺少中繼資料、筆記結構不一致，或你自己都還不確定 base 應該顯示什麼，就不適合先用 obsidian-bases。它也不能取代 Bases 格式之外的外掛專屬文件。如果你的 vault schema 很混亂，應該先把這件事整理好。
obsidian-bases 能幫忙處理公式與函式嗎？
可以。就安裝評估角度來看，內附的 references/FUNCTIONS_REFERENCE.md 是這個技能最有價值的部分之一。當你需要日期運算、條件顯示、型別轉換、連結、icons，或在公式驅動欄位中輸出 HTML 時，它都很有幫助。
如何改進 obsidian-bases 的使用效果
在要求輸出前，先提供更乾淨的 vault schema
最大的改善槓桿其實是輸入品質。要求完整 base 之前，先列出 3–5 則筆記中的確切 property 名稱與範例值。如果某一則筆記用 due-date，另一則卻用 due，代理就無法可靠地設計 filter 或 formula。
避免最常見的 obsidian-bases 失敗情況
常見失敗模式包括：
- 因未加引號的字串而產生無效 YAML
- 公式參照在定義前就被使用
- filter 指向不存在的 tag 或 property
- 第一版就同時塞入多個檢視與 summaries，導致過度複雜
更好的第一個請求應該收斂一些：一個資料夾、一個 filter、一個 view、一個 formula。
從可運作的最小輸出逐步迭代 obsidian-bases
若想提高 obsidian-bases 的成功率，建議分層要求修訂：
- 第一輪：有效的
.base，包含一個 filter 與一個 view - 第二輪：加入計算欄位
- 第三輪：加入替代檢視與 summaries
- 最後一輪：請代理說明假設條件與可能的 schema 不一致處
這樣做更可靠，因為你可以清楚看出到底是哪一項新增內容讓渲染失敗。
策略性使用 reference file
想改善 obsidian-bases 的輸出品質，不要抽象地要求「進階公式」。請直接描述你要的運算，再讓代理對照 references/FUNCTIONS_REFERENCE.md 中已知的函式去映射。這樣輸出會更貼近已記錄的函式集合，也能減少憑空猜測語法的情況，尤其是在日期、布林值、連結與顯示格式化這幾類需求上。