用途：attach-db 用于将 DuckDB 数据库文件附加到 duckdb-skills 的交互式查询流程中，并生成后续查询可复用的状态文件。
主要能力：解析数据库绝对路径；检查文件是否存在，不存在时可询问是否新建空库；确认 DuckDB 已安装（未安装则转交 /duckdb-skills:install-duckdb）；用 PRAGMA version 校验数据库；列出所有表及 estimated_size；对最多 20 张表执行 DESCRIBE 和 count() 获取列定义与行数；解析状态目录并追加 ATTACH 语句到共享 state.sql；最后用 duckdb -init 验证状态文件。
使用方式：技能接收数据库路径参数 $0。相对路径会基于 $PWD 解析为绝对路径。状态文件位置有两种：项目目录 .duckdb-skills/state.sql，或 $HOME/.duckdb-skills/<project-id>/state.sql，由用户选择。state.sql 为累积文件，不会覆盖，只检查重复后追加，内容形如 ATTACH IF NOT EXISTS '路径' AS 别名; USE 别名;。别名默认取文件名去扩展名。
适用场景：需要在 duckdb-skills 中打开本地 DuckDB 文件并了解其表结构、行数，或为后续查询准备会话状态时。
限制：资料未提供收费、价格、平台支持范围等信息；若文件损坏或非 DuckDB 数据库会报错停止；表探索上限为 20 张；别名冲突时需用户指定名称。