技能介绍

这个配置生成器解决什么问题

写 Airbyte 连接器时，最麻烦的往往不是数据拉取逻辑本身，而是配置结构。sourceDefinitionId、spec、connectionSpecification、checkConnection 的返回格式……任何一个字段拼错，airbyte-ingestion 在校验阶段就会直接失败，而且报错常常指向协议层而不是你的代码。手工对照文档拼 JSON，既慢又容易在字段名上翻车。

它是怎么工作的

核心思路是把配置生成从「手写 JSON」变成「调用 API + 协议校验」：

调用 /v1/sources/create 生成源连接器配置，调用 /v1/destinations/create 生成目标连接器配置。
按 Airbyte 协议 校验生成的连接规范，确认字段结构、必填项与类型符合协议定义。
把校验结果直接反馈给你，而不是等到 CI 里跑 airbyte-integrations 时才发现问题。

关键步骤大致是：先确认目标环境是 Airbyte 开源版 还是 Airbyte Cloud，拿到可用的 API 访问方式；再构造 create 请求；最后把返回的配置接到 CDK 或无代码连接器构建器里继续开发。

适用边界与注意点

这个技能负责的是配置生成与协议校验，不等于连接器运行时能力，数据同步本身仍由 Airbyte 的连接器框架执行。
上游资料要求：提交 PR 时勾选 Allow maintainers to edit，并且 PR 必须从你个人 GitHub 账户的分叉创建，否则 Airbyte 维护者无法合并。
原始内容抽取自 airbytehq/airbyte 的 README 与 1991513ccie-png/skills，上游文档会随仓库变化，字段定义以你实际使用的 Airbyte 版本为准。
如果只是想知道某个连接器能不能用，直接用现成连接器比生成配置更快。