install-duckdb

install-duckdb 技能概览

install-duckdb 是做什么的

install-duckdb 技能用于通过 CLI 安装或更新 DuckDB 扩展。它面向那些想要一个稳定、可重复的 install-duckdb 安装流程，而不是手写零散 INSTALL 语句的人。这个技能接受核心扩展的纯扩展名，也接受托管在某个仓库中的扩展 name@repo 形式。

谁适合使用它

如果你已经在 DuckDB 里工作，并且需要更快、更可复用、少猜语法地添加扩展，就适合用这个 install-duckdb 技能。它尤其适合代理或用户：当你只给出一句模糊需求，比如“安装 spatial 和一个社区扩展”时，它能把这类请求收敛成一条短而可执行的 DuckDB 命令路径。

它有什么不同

install-duckdb for Skill Installation 的核心价值在于，它能把一小段输入列表转换成正确的 DuckDB INSTALL 形式，并且把 --update 路径单独处理。这样一来，这个技能既适合首次安装，也适合维护性工作流。它还会先检查 DuckDB CLI 是否可用，避免流程走到后面才出现让人困惑的失败。

如何使用 install-duckdb 技能

安装技能并确认 DuckDB 可用

进行 install-duckdb install 时，先通过你的 GitHub skill workflow 加载这个技能，然后在让它开始之前，确认 duckdb 已经在你的 PATH 里。如果找不到 DuckDB，技能会主动停止，并提示你先安装 CLI。这样做很重要，因为这个技能不是 package manager，而是一个了解 DuckDB 的安装封装器。

给技能干净的扩展输入

最好的 install-duckdb usage，从技能能直接解析的名称开始：

• spatial
• fts
• magic@community

当你要使用 DuckDB 的核心仓库时，用纯名称即可；当扩展来自非默认仓库时，用 name@repo。如果你要更新，只需加上 --update，并且只列出你真正想触碰的扩展目标。

按正确顺序阅读仓库

做 install-duckdb guide 相关工作时，先看 SKILL.md，了解参数规则和执行流程。然后再检查 eval.sh，看维护者是如何在实践中验证行为的。这个文件尤其适合你想弄清楚安装后什么才算“成功”，以及这个技能在自动化场景下应该如何表现时参考。

把模糊需求改写成更好的提示词

更强的提示词能减少歧义。不要只说“安装 DuckDB 扩展”，而要写成：
/duckdb-skills:install-duckdb spatial fts
或者
/duckdb-skills:install-duckdb --update magic@community
只包含你要的扩展，明确写出非核心仓库名称，避免把无关任务混在同一个请求里。这个技能最适合那种提示词足够具体、生成的 DuckDB 语句一眼就清楚的场景。

install-duckdb 技能常见问题

install-duckdb 只能用于安装吗？

不是。install-duckdb 技能也支持更新扩展，这在你需要刷新现有环境而不是新增内容时很有用。这个更新路径也是它比一次性提示词更实用的原因之一。

我需要先安装 DuckDB 吗？

需要。这个技能会检查 DuckDB CLI，如果找不到就会停止。如果你正在评估 install-duckdb for Skill Installation，这个前置条件是实打实的采用门槛，不是小细节。

什么情况下不该用这个技能？

如果你要管理的是无关的系统包、Python 依赖或数据库迁移，就不要用它。这个技能只聚焦 DuckDB 扩展的安装和更新行为。如果你的目标是更广泛的环境搭建，通用提示词或其他技能会更合适。

它适合新手吗？

适合，前提是使用者能说清自己要哪些扩展。这个技能会隐藏 DuckDB 语法细节，但它仍然要求用户知道某个扩展是核心扩展，还是来自另一个仓库。新手最好的做法，是直接按 DuckDB 文档或发布说明里的写法提供扩展名。

如何改进 install-duckdb 技能

指定准确的扩展目标

提升质量最大的方式，是把扩展列表写得更准确。如果你希望 install-duckdb usage 一次就成功，就把每个目标都清楚写出来，并且只在确有需要时才加 @repo。像“安装一些有用的扩展”这种模糊请求，只会迫使系统猜测，降低输出质量。

区分安装意图和更新意图

常见失败模式，是把“安装这个”和“更新全部”混在同一个请求里。install-duckdb skill 对这两种情况的处理方式不同，所以你要明确写出自己想要的模式。如果你要更新，就开门见山地说清楚，并且只列出真正重要的扩展。

首次运行后验证结果

为了更高的把握，在技能运行后，最好确认扩展是否能在 DuckDB 中成功加载。真正成功的 install-duckdb install，检验标准不是“有没有打印出命令”，而是扩展是否真的能用。如果某个扩展加载失败，就回头检查仓库来源、扩展拼写，以及它到底应该来自核心仓库还是某个指定仓库。