Api Connector Builder

affaan-m/ECC/docs/zh-CN/skills/api-connector-builder

by affaan-mef648e01899ba3e8dc6371642deaaf64b4477775No license275K starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated 4 days ago

通过匹配目标仓库现有的集成模式，构建一个新的API连接器或提供者。适用于在不发明第二种架构的情况下添加一个集成。

Instructions onlySoftware Development
AI-generated overview

Builds a new API connector or provider that matches an existing repository's integration patterns.

What it does
Guides the agent through adding a repository-native integration interface rather than a generic HTTP client. It has the agent study at least two existing connectors, scope the target integration's auth, entities, operations, pagination and webhook model, then build in the repository's native layers and verify against the source patterns. It produces connector code following the host repository's layout, configuration, error handling, registration and test conventions.
When to use it
Use when a task asks to add a new integration, connector, provider or plugin to a project that already has an integration architecture. It fits requests such as building a Jira connector or adding a Slack provider in the style of existing connectors.
Requirements
Instructions only; no scripts are shipped. It needs access to the target repository and its existing connectors, and the relevant runtime and dependencies of that repository.

API 连接器构建器

当任务需要添加仓库原生的集成接口，而非仅通用 HTTP 客户端时使用此工具。

关键在于匹配宿主仓库的模式：

  • 连接器布局
  • 配置模式
  • 认证模型
  • 错误处理
  • 测试风格
  • 注册/发现机制

使用时机

  • "为此项目构建 Jira 连接器"
  • "按照现有模式添加 Slack 提供商"
  • "为此 API 创建新集成"
  • "构建符合仓库连接器风格的插件"

约束条件

  • 若仓库已有集成架构，不得自行发明新架构
  • 不得仅从供应商文档入手；应优先参考仓库内现有连接器
  • 若仓库需要注册机制、测试和文档，不得仅停留在传输代码层面
  • 若仓库有更新的当前模式，不得盲目复制旧连接器

工作流程

1. 学习内部风格

检查至少 2 个现有连接器/提供商，并映射：

  • 文件布局
  • 抽象边界
  • 配置模型
  • 重试/分页约定
  • 注册钩子
  • 测试夹具和命名规范

2. 缩小目标集成范围

仅定义仓库实际需要的接口：

  • 认证流程
  • 关键实体
  • 核心读写操作
  • 分页和速率限制
  • Webhook 或轮询模型

3. 按仓库原生层次构建

典型分层：

  • 配置/模式
  • 客户端/传输层
  • 映射层
  • 连接器/提供商入口
  • 注册机制
  • 测试

4. 对照源模式验证

新连接器应在代码库中显得自然，而非从不同生态导入。

参考模板

提供商风格

text
providers/  existing_provider/    __init__.py    provider.py    config.py

连接器风格

text
integrations/  existing/    client.py    models.py    connector.py

TypeScript 插件风格

text
src/integrations/  existing/    index.ts    client.ts    types.ts    test.ts

质量检查清单

  • [ ] 匹配仓库内现有集成模式
  • [ ] 存在配置验证
  • [ ] 认证和错误处理明确
  • [ ] 分页/重试行为遵循仓库规范
  • [ ] 注册/发现机制完整
  • [ ] 测试镜像宿主仓库风格
  • [ ] 若仓库要求，更新文档/示例

相关技能

  • backend-patterns
  • mcp-server-patterns
  • github-ops

Source and attribution

Source:affaan-m/ECCindocs/zh-CN/skills/api-connector-builderat commitef648e0

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from affaan-m/ECC

Unified Notifications Ops

affaan-m

Designs a unified notification policy that classifies, routes, deduplicates and escalates alerts across GitHub, Linear, hooks and chat.

Productivity & Workflow275Kupdated 4 days ago

Verification Loop

affaan-m

Runs a six-phase code verification loop and produces a PASS/FAIL readiness report.

Software Development275Kupdated 4 days ago

Ui To Vue

affaan-m

Converts batches of UI design screenshots into Vue 3 components using Vant, Element Plus, or Ant Design Vue.

Software Development275Kupdated 4 days ago

Unified Memory

affaan-m

Guides agents in sharing durable context and handoffs between harnesses through the local ECC Memory Vault.

AI & Agents275Kupdated 4 days ago

Visa Doc Translate

affaan-m

OCR-translates visa document images into English and produces a bilingual PDF with the original image and translation.

Documents & Office275Kupdated 4 days ago

Team Builder

affaan-m

Interactive picker that discovers agent personas, lets a user select up to five, runs them in parallel on one task, and synthesizes the results.

AI & Agents275Kupdated 4 days ago

More in Software Development

Playground

anthropics

Featured

Builds self-contained interactive HTML playgrounds with controls, live preview, and copyable prompt output.

Software Development37Kupdated today

M5 Onboard

anthropics

Featured

Provisions M5Stack ESP32 boards by detecting them on USB, flashing UIFlow 2.0 firmware, and installing a MicroPython app bundle.

Software Development37Kupdated today

Cardputer Buddy

anthropics

Featured

Guides iterating on a Cardputer-Adv MicroPython app bundle: adding apps, pushing files over USB-serial, tailing logs, and running REPL commands.

Software Development37Kupdated today

Web Design Guidelines

vercel-labs

Featured

Reviews UI code against Web Interface Guidelines fetched from a remote source and reports findings as file:line entries.

Software Development32Kupdated 5 weeks ago

Vercel React Native Skills

vercel-labs

Featured

React Native and Expo best-practice rules covering list performance, animation, navigation, UI patterns, state, and monorepo setup.

Software Development32Kupdated 5 weeks ago

Vercel React Best Practices

vercel-labs

Featured

Vercel's React and Next.js performance guidelines, organized as 70 rules for writing, reviewing, and refactoring code.

Software Development32Kupdated 5 weeks ago