Data Tool Integration Planner

目标

帮助用户把“我要接一个工具或数据库”拆成可配置、可验证、可交付的集成方案。

这个 Skill 是基础 Infra 类 Skill，服务于数据库、API、BI、调度、存储、消息通知等工具对接。

使用场景

使用这个 Skill，当用户需要：

• 连接 MySQL、PostgreSQL、ClickHouse、Hive、Spark、Doris、StarRocks 等数据库或数仓
• 对接 BI、调度平台、数据质量平台、工单系统、飞书/钉钉/企业微信等三方工具
• 判断某个工具是否有 API、Webhook、JDBC/ODBC、CLI 或导出能力
• 设计配置表、连接参数、权限、密钥和环境变量
• 为自动化工作流准备可复用的工具接入上下文

不适用场景

不要使用这个 Skill 处理：

• 实际保存明文密码、Token 或密钥
• 在没有授权的情况下连接生产数据库
• 编写业务 SQL（本 Skill 不写 SQL；已有 SQL 的审查请使用 sql-reviewer）
• 设计数据表，应使用 table-design-advisor
• 排查具体任务失败（本库暂无对应 Skill，不要用本 Skill 代替）
• 设计实时计算逻辑，应使用 stream-pipeline-designer

输入信息

最少输入：

• 工具名称
• 工具类型：database、api、bi、workflow、storage、message
• 接入目标
• 当前已知连接方式

推荐输入：

• 是否有官方 API、Webhook、JDBC/ODBC、CLI、SDK
• 环境：dev、test、prod
• 认证方式：账号密码、Token、OAuth、AK/SK、服务账号、内网免密
• 网络要求：公网、内网、VPN、白名单、堡垒机
• 权限范围：只读、写入、管理、回调
• 数据范围和频率
• 安全要求：密钥管理、脱敏、审计、最小权限

上下文建议

优先使用这些模板准备上下文：

• 工具集成上下文模板
• 通用数据任务上下文
• SQL 审查上下文模板

如果用户不能确认工具是否有 API，应先让用户补充官方文档、控制台截图或接口说明；没有证据时只能列出待确认问题。

可用脚本

本 Skill 附带一个配置校验脚本：

node scripts/validate_integration_config.mjs <config.json>

在本 Skill 目录下运行。脚本只做本地 JSON 校验，不连接真实服务。配置里任何位置出现明文密码、Token、API Key，或连接串带密码，都会报错。

配置格式见 配置格式，示例见 assets/example_database_config.json。

工作流程

1. 识别工具类型和接入目标。
2. 判断可用接入方式：API、Webhook、JDBC/ODBC、CLI、SDK、文件导出。
3. 列出必须向用户确认的配置项。
4. 设计安全配置：环境变量、密钥引用、最小权限、网络白名单。
5. 输出连接配置模板和验证步骤。
6. 对缺失 API 或无法直连的工具，给出替代方案：文件导出、Webhook、中转服务或人工上传。

输出格式

## 集成方案结论

## 工具与接入目标

## API / 连接能力确认

| 能力 | 是否已确认 | 证据/待确认 |
| --- | --- | --- |

## 配置项清单

| 配置项 | 是否必填 | 示例 | 安全要求 |
| --- | --- | --- | --- |

## 权限与安全

## 验证步骤

## 配置模板

## 待用户确认问题

质量标准

输出必须：

• 不要求用户粘贴明文密码或 Token
• 对 API、Webhook、JDBC/ODBC、CLI 等能力标记“已确认”或“待确认”
• 给出最小权限建议
• 明确网络、认证、环境变量和审计要求
• 提供可复制的配置模板
• 不能假设某个工具一定有 API

完成后的下一步

• 接入后建实时链路：stream-pipeline-designer
• 接入后建表：table-design-advisor
• 写接入说明：data-doc-writer

示例 Prompt

请用 data-tool-integration-planner 帮我规划一个数据库接入方案。

工具名称：PostgreSQL
工具类型：database
接入目标：读取演示环境中的订单和用户表，用于 SQL 审查和数据分析示例。
环境：demo
已知配置：
- host: pg-demo.internal
- port: 5432
- database: analytics_demo
- auth: 用户名 + 密码
安全要求：
- 不允许在文档中保存明文密码
- 只读权限
- 需要记录连接配置模板和验证步骤

请输出配置方案、待确认问题和本地配置 JSON 示例。

请用 data-tool-integration-planner 规划这个 BI 工具接入方案。

工具名称：Metabase
工具类型：BI
接入目标：连接公司 PostgreSQL 数仓，支持数据团队自助查询和 SaaS 经营看板搭建。
环境：prod
认证方式：数据库账号 + 密码
安全要求：Metabase 只读权限，禁止修改数仓表，敏感字段（salary、contact）需要脱敏

请输出接入步骤、权限配置建议、安全检查清单和验证步骤。