duckdb-docs
作者 duckdbduckdb-docs 可讓你搜尋 DuckDB 與 DuckLake 的文件、部落格文章，以及來自本機 DuckDB 快取的已索引參考區塊。適合需要有來源依據的回答、精準術語，以及在技術寫作流程中需要明確章節引用時使用 duckdb-docs。
這個技能評分為 74/100，代表它很值得列入目錄：它確實提供了可觸發的 DuckDB 與 DuckLake 文件搜尋流程，但描述仍偏精簡，而且缺少安裝指令與支援參考檔，導入門檻仍有一些摩擦。使用者可期待的是實用的文件檢索技能，而不是已經打磨完善的套件。
- 觸發條件與輸入格式清楚：描述明確指出它會搜尋 DuckDB/DuckLake 文件，並接受問題或關鍵字。
- 工作流程具體可操作：會先檢查 DuckDB、安裝必要的 extensions、在兩個已文件化的索引之間選擇，然後執行搜尋查詢。
- 對代理有良好幫助：它會從本機快取的全文索引回傳相關文件區塊，相較一般網頁搜尋提示更能減少猜測。
- 中繼資料偏少：description 長度只有 1，而且沒有安裝指令，會讓目錄評估與上手都不夠直觀。
- 沒有附上支援檔或參考資料，因此使用者主要仍得依賴 SKILL.md 來理解邊界情況與行為。
duckdb-docs 技能概覽
duckdb-docs 的用途
duckdb-docs 技能可讓你從本機 DuckDB 快取中搜尋 DuckDB 與 DuckLake 的文件、部落格文章，以及已索引的參考片段。它特別適合回答「這段有寫在哪裡？」或「文件對這個功能是怎麼說的？」這類問題，而且通常比手動翻網站快得多。
適合哪些人
如果你在撰寫技術內容、支援使用者，或需要針對 DuckDB／DuckLake 取得有明確來源依據的精準答案，duckdb-docs 技能會很有用。它特別適合 duckdb-docs for Technical Writing 這類工作流程，因為你需要的是精確術語、章節參照與相關文件摘錄，而不是泛泛的摘要。
為什麼它不一樣
這不是一個通用聊天提示。duckdb-docs 技能預期你提供的是簡短問題或關鍵字，先檢查 DuckDB 與必要擴充功能是否存在，接著再搜尋快取的全文索引。這讓它在需要快速檢索時非常實用，但也代表你的輸入必須夠具體，搜尋索引才會發揮效果。
如何使用 duckdb-docs 技能
安裝技能
先依照 GitHub 的技能安裝流程安裝 duckdb-docs，然後確認這個技能已在你的代理人環境中可用。duckdb-docs install 這一步本身不難，真正的關鍵是你要有可正常運作的本機 DuckDB CLI，因為這個技能會直接用到它。
用適合搜尋的方式提問
duckdb-docs usage 的提問方式應該是問題、關鍵字或短主題，而不是一大段說明。好的輸入像這樣：
How does DuckDB handle list aggregation?DuckLake catalogsHTTPFS extension install errorcurrent docs for COPY INTO
如果你已經知道文件家族，也一起帶上。通常，聚焦的查詢會比像「解釋 DuckDB」這種寬泛要求，拿到更好的片段。
跟著工作流程走，並檢查正確的檔案
先從 SKILL.md 開始看，因為它包含執行順序與搜尋索引的選擇邏輯。這個 repo 裡沒有需要先讀的 helper scripts 或 reference folders，所以真正有價值的是先理解 DuckDB CLI 檢查、擴充功能安裝，以及兩個索引選項：DuckDB docs/blog 與 DuckLake docs。
提高檢索品質的實用技巧
依照意圖選索引：一般問題預設用 DuckDB docs + blog；如果主題是 catalogs、preview/stable 行為，或 DuckLake 專屬功能，就明確寫出 DuckLake。若你需要的是精確措辭，就不要只問大意，直接要求章節或 chunk。對於 duckdb-docs guide 這類任務，盡量一次只聚焦一個概念與一個版本目標。
duckdb-docs 技能 FAQ
duckdb-docs 只用於 DuckDB 文件嗎？
不是。這個技能同時涵蓋 DuckDB docs/blog 內容與 DuckLake 文件，而且索引會依你的查詢來選。只要你的請求提到 DuckLake，就應該導向 DuckLake 的搜尋快取，而不是預設的 DuckDB 索引。
安裝前我需要知道什麼？
主要的風險在環境設定，不在文件索引本身。這個技能會檢查 duckdb 指令，並且要求 httpfs 與 fts 擴充功能安裝成功。只要其中一項缺少，搜尋流程就會提早中止。
它比一般提示詞更好嗎？
如果你需要有來源依據的檢索，答案是肯定的。一般提示詞可以解釋概念，但 duckdb-docs 的設計目標是快速找到最相關的文件片段。這讓它在找引用、檢查術語，以及把模糊問題縮小到正確頁面或章節時特別有用。
什麼情況下不適合用？
如果你需要程式執行、資料分析，或不依賴文件的廣泛概念性回答，就不要用 duckdb-docs。它是一個搜尋與檢索技能，因此在使用者已經知道主題，或能明確說出關鍵字時效果最好。
如何改進 duckdb-docs 技能
讓第一個查詢更聚焦
品質提升最大的一步，就是把輸入寫得更清楚。與其說 How do I load files?，不如改成 DuckDB read CSV with read_csv_auto 或 DuckLake authentication docs。這樣搜尋步驟比較能回傳相關片段，而不是只有接近但沒用的頁面。
指定你要的輸出形式
如果你要的是可用於寫作、支援或培訓素材的文件，就直接說明。duckdb-docs for Technical Writing 在你要求精確章節名稱、簡短原文引句，或最能解釋某個功能行為的頁面時，表現會更好。這能減少改寫，也讓結果更容易核對。
注意環境失敗
常見失敗模式包括：缺少 DuckDB、擴充功能安裝失敗，或你問到的主題其實屬於錯誤的索引。如果技能回報擴充功能或 CLI 錯誤，先修好環境；如果結果集合看起來不對，就改用更精確的詞，或直接指定 DuckDB 與 DuckLake。
從關鍵字迭代到問題
好的 duckdb-docs 工作方式是：先用關鍵字開始，檢查回傳的片段，再把第二次查詢改成明確指定功能、錯誤或版本。這種迭代式流程通常比試圖用一個寬泛提示詞一次解決所有問題，更快也更準確。