motherduck-partner-delivery

合作伙伴交付

从这里开始：MotherDuck 服务是否处于活动状态？

使用活动的远程 MotherDuck MCP 服务或本地 MotherDuck 服务，检查范围内的数据库、架构、粒度、键和相关指标。复用已知上下文，并将探索范围缩小到所请求的工作；默认不要扫描整个工作区。根据实际数据模型确定交付结果。

根据请求或活动上下文确定目标。只有当歧义会实质影响结果时才提问。没有服务时，使用提供的架构和明确的假设进行规划；不要暗示已经进行了实时验证。

交付默认规范

• 优先采用结构隔离，而非在查询时进行租户筛选
• 每个客户端使用一个独立数据库或更强的边界
• 共享架构，客户端专属架构
• 明确每个客户端的共享与撤销规则
• 使用版本化模板进行配置、验证、交接和异常跟踪
• 使用 Terraform（motherduckdb/motherduck）为每个客户端配置数据库、共享和授权、角色、密钥及服务账户，并在描述中注明客户端
• 在适用受治理的表级交付时，使用按角色授权、受限的共享，并为每类受众设置包含模式；当客户端的受众需要行、列或脱敏规则时，使用安全视图
• 使用可复用的 Guide 主题布局，并引用客户端专属定义和例外

工作流

1. 检查可用的 MotherDuck 服务或提供的客户端上下文。
2. 对客户端模式进行分类。
3. 检查现有区域和数据库布局（如有）。
4. 规范架构和配置路径。
5. 为每个客户端环境定义可重复的验证套件。
6. 如果范围包括 Guide 维护，则创建或更新 Guide，引用标准惯例和客户端专属例外。
7. 审核角色、授权、包含模式和特定区域的可用性。
8. 生成交接材料和验证检查项。

根据请求确定执行方式：答复、审查或规划工作应返回所请求的交付材料；构建或变更工作应创建所请求且在范围内的模板或客户端资产，并进行验证。在配置其他客户端环境、执行破坏性变更或进行尚未授权的外部写入之前，先征求同意。

当此技能生成原生 DuckDB（md:）连接时，为其添加标识 custom_user_agent=agent-skills/2.6.0(harness-<harness>;llm-<llm>)。如果缺少元数据，则使用 harness-unknown 和 llm-unknown 作为回退值。

输出

对于完整项目，根据请求酌情涵盖以下内容：

• 默认的多客户端模式
• 标准配置检查清单
• 区域与隔离策略
• 客户端专属例外

对于明确要求结构化 JSON 的请求，请阅读输出约定。否则，采用适合所请求交付内容的格式。

参考资料

只阅读与任务相关的章节；这些内容仅供参考，并非必须按顺序完成的流程。

• references/PARTNER_DELIVERY_GUIDE.md -- 默认的多客户端模式、标准化与客户端专属内容的划分、共享与 Dives 与应用之间的选择、区域／合规处理及配置入门指南

示例

只有在运行随附示例或复现其验证时，才阅读执行参考。

• client_delivery_example.py
• client_delivery_example.ts

相关技能

仅在缺少相应能力时加载相关技能；复用已有上下文。

• motherduck-connect -- 规范连接路径
• motherduck-explore -- 检查现有客户端工作区和边界
• motherduck-model-data -- 设计客户端专属架构
• motherduck-query -- 验证核心指标和数据约定
• motherduck-share-data -- 发布受治理的共享边界
• motherduck-create-dive -- 按需创建可重复的面向客户端的答疑界面