用途
MotherDuck CLI 技能用于在终端环境中操作 MotherDuck，支持终端查询、身份认证，以及基于文件的 Dive 或 Flight 工作流。它面向需要通过命令行与 MotherDuck 交互的代理或开发者，帮助完成查询执行、资源操作和项目文件管理。
主要能力
- 终端查询：使用 motherduck query 执行查询，并选择最小的合适输出格式。
- 身份认证：通过 motherduck status 检查认证状态，复用已认证的 CLI；自动化场景下可通过环境变量 MOTHERDUCK_TOKEN 传入令牌。
- 机器可读输出：对资源操作请求 --output json，并检查退出码与返回的 success 字段；motherduck query --output json 返回的是裸 JSON 数组。
- Dive 与 Flight 工作流：支持拉取或初始化本地项目、编辑文件、验证或预览，并在需要发布时推送。
- 内置指南：在编写或编辑 Dive 或 Flight 前，运行 motherduck dive guide 或 motherduck flight guide 获取当前运行时约定。
- 代理隔离：为并行代理设置绝对且任务专属的 MOTHERDUCK_HOME，避免共享凭据或资产。
使用方式
- 检查宿主项目以及现有 CLI 与认证状态。
- 仅在需要时按照当前平台相关文档安装或升级。
- 根据任务形态选择 CLI 或 MCP：涉及文件、本地编辑、CI、大结果或反复迭代时使用 CLI；仅聊天探索、内联回答或无文件系统时使用 MCP；混合工作流可先通过 MCP 探索，再通过 CLI 从本地文件构建。
- 查询时使用 motherduck query 并选择最小合适的输出格式。
- 处理 Dive 或 Flight 时，先阅读其内置指南，拉取或初始化本地项目，编辑文件，验证或预览，仅在要求发布时推送。
- 从 JSON 输出中捕获资源 ID、URL 或运行编号，并在变更后验证远程状态。
- 遇到解析或选项错误时，使用 motherduck <command> --help 而非猜测语法。
适用场景
- 需要在终端中执行 MotherDuck 查询并控制输出格式。
- 需要以文件为基础管理 Dive 或 Flight 项目并进行本地编辑与验证。
- 自动化流程中需要隔离凭据、传递令牌并获取机器可读结果。
- 需要区分仅提供建议的请求与明确要求构建或变更的请求。
限制与注意事项
- 应以当前 MotherDuck CLI 文档和命令参考为准，命令表面可能变化。
- 大型查询结果应重定向到文件，而非全部拉入模型上下文。
- 不得仅因缺少认证而运行 motherduck new；账户创建需要明确的注册请求。
- dive push、flight push、调度、密钥变更和账户创建属于外部变更，仅在用户请求包含该结果时执行。
- 对于回答、审查或规划类请求，应推荐命令而不登录、不创建账户、不更改远程资源；对于明确的构建或变更请求，完成范围内的 CLI 工作流并验证结果，破坏性删除或明显更广的外部变更前需先询问。
- 相关技能仅在缺少能力时加载，包括 motherduck-connect、motherduck-explore、motherduck-query、motherduck-create-dive 和 motherduck-create-flight。
- 参考资料方面，仅阅读当前任务所需的参考章节；references/CLI_PLAYBOOK.md 涵盖安装、认证、JSON 契约、查询模式、代理隔离以及完整的 Dive/Flight 文件工作流。
暂未提供的信息
关于该技能的具体收费、价格、支持平台、性能效果或详细使用步骤，资料中暂未提供。