install-duckdb

install-duckdb 技能總覽

install-duckdb 是做什麼的

install-duckdb 技能會透過 CLI 安裝或更新 DuckDB extension。它是為了那些想要一套穩定的 install-duckdb 安裝流程，而不是自己手寫零散 INSTALL 指令的人而設計。這個技能可接受核心 extension 的純名稱，也可接受來自 repository 的 name@repo 配對。

誰適合使用這個 install-duckdb 技能

如果你已經在使用 DuckDB，並且需要更快、更可重複地加入 extension，同時減少語法猜測，那麼這個 install-duckdb 技能就很適合你。它特別適合 agent 或使用者，能把像「安裝 spatial 和一個 community extension」這種模糊需求，快速收斂成可直接執行的 DuckDB 指令。

它和其他方式有什麼不同

install-duckdb for Skill Installation 的主要價值，在於它會把一小串輸入轉成正確的 DuckDB INSTALL 形式，並且把 --update 流程獨立處理。這讓這個技能同時適合首次安裝與維護工作流程。它也會先檢查 DuckDB CLI 是否可用，避免流程走到後面才出現令人困惑的失敗。

如何使用 install-duckdb 技能

安裝技能並確認 DuckDB 已就緒

進行 install-duckdb install 時，先透過你的 GitHub skill workflow 載入這個技能，然後在要求它執行任何動作之前，先確認 duckdb 已經在你的 PATH 裡。如果找不到 DuckDB，這個技能的設計會是直接停止，並提醒你先安裝 CLI。這一點很重要，因為這個技能不是套件管理器；它是一個懂 DuckDB 的安裝包裝器。

提供乾淨、可解析的 extension 輸入

最好的 install-duckdb usage，會從技能能直接解析的名稱開始：

• spatial
• fts
• magic@community

當你要使用 DuckDB 的核心 repository 時，請輸入純名稱。當 extension 來自非預設 repo 時，請使用 name@repo。如果你想要更新，請加上 --update，而且只列出你真的要處理的 extension 目標。

依正確順序閱讀 repo

在進行 install-duckdb guide 相關工作時，先從 SKILL.md 開始，理解參數規則與執行流程。接著檢視 eval.sh，看看維護者實際上如何驗證行為。那個檔案特別適合用來理解安裝完成後什麼叫做「成功」，以及這個技能在自動化情境下預期如何表現。

把模糊需求改寫成更好的 prompt

更強的 prompt 能減少歧義。與其說「安裝 DuckDB extensions」，不如改成：
/duckdb-skills:install-duckdb spatial fts
或
/duckdb-skills:install-duckdb --update magic@community
只包含你要的 extension，非核心 repo 請明確標出名稱，並避免把無關任務混在同一個請求裡。當 prompt 夠具體，生成的 DuckDB 指令就會更明顯，也更容易正確執行。

install-duckdb 技能常見問題

install-duckdb 只支援安裝嗎？

不是。install-duckdb 技能也支援更新 extension，這在你不是要新增東西，而是要刷新既有設定時特別有用。這條更新路徑也是它比一次性 prompt 更實用的原因之一。

我需要先安裝 DuckDB 嗎？

需要。這個技能會檢查 DuckDB CLI，如果找不到就會停止。如果你正在評估 install-duckdb for Skill Installation，這個前置條件是實際的導入門檻，而不是小細節。

什麼情況下不該用這個技能？

如果你要管理的是無關的系統套件、Python dependencies，或 database migration，就不該用它。這個技能的重點非常明確，只聚焦在 DuckDB extension 的安裝與更新行為。如果你的目標是更廣泛的環境建置，通用 prompt 或其他技能會更適合。

這個技能對新手友善嗎？

可以，只要使用者能清楚說出自己要哪些 extension。這個技能會幫你隱藏 DuckDB 語法細節，但它仍然要求使用者知道 extension 是核心內建，還是來自其他 repo。新手最適合的做法，是直接提供與 DuckDB 文件或 release notes 中一致的 extension 名稱。

如何改進 install-duckdb 技能

明確指定 extension 目標

最大的品質提升，來自更好的 extension 清單。如果你想讓 install-duckdb usage 一次就成功，請清楚列出每個目標，只有在需要時才加上 @repo。像「安裝有用的 extensions」這種模糊要求，只會讓系統猜測，並削弱輸出品質。

把安裝與更新意圖分開

常見的失敗模式，是把「安裝這個」和「把全部都更新」塞進同一個請求裡。install-duckdb skill 會以不同方式處理這兩種情境，所以你要明確說出想用哪一種模式。如果你是在更新，請一開始就說清楚，並只列出真正相關的 extensions。

第一次執行後先驗證結果

若要提高把握，技能執行完後，請在 DuckDB 裡確認 extension 能順利載入。這才是 install-duckdb install 成功與否的真正測試，而不只是有沒有印出一段指令而已。如果某個 extension 載入失敗，請回頭檢查 repo 來源、extension 拼字，以及它到底應該來自核心 repo 還是特定 repo。