Was macht API-Connector-Builder?
Verwenden Sie diesen Skill, wenn die Aufgabe darin besteht, eine reposnative Integrationsfläche hinzuzufügen – nicht nur einen generischen HTTP-Client.
Ziel ist es, dem Muster des Host-Repositorys zu folgen:
- Connector-Layout
- Konfigurationsschema
- Authentifizierungsmodell
- Fehlerbehandlung
- Teststil
- Registrierungs-/Discovery-Verdrahtung
Wann zu verwenden
- „Erstelle einen Jira-Connector für dieses Projekt“
- „Füge einen Slack-Provider nach dem bestehenden Muster hinzu“
- „Erstelle eine neue Integration für diese API“
- „Erstelle ein Plugin, das dem Connector-Stil des Repos entspricht“
Guardrails
- Erfinden Sie keine neue Integrationsarchitektur, wenn das Repository bereits eine besitzt
- Beginnen Sie nicht nur mit der Dokumentation des Anbieters; beginnen Sie zuerst mit den vorhandenen Connectors im Repo
- Hören Sie nicht beim Transportcode auf, wenn das Repository Registrierungs-Verdrahtung, Tests und Dokumentation erwartet
- Kopieren Sie nicht blind alte Connectors, wenn das Repository ein neueres, aktuelles Muster hat
Workflow
1. Lernen Sie den Hausstil
Überprüfen Sie mindestens 2 bestehende Connectors/Provider und erfassen Sie:
- Dateistruktur
- Abstraktionsgrenzen
- Konfigurationsmodell
- Wiederholungs-/Paginierungskonventionen
- Registry-Hooks
- Test-Fixtures und Benennung
2. Grenzen Sie die Zielintegration ein
Definieren Sie nur die Oberfläche, die das Repository tatsächlich benötigt:
- Authentifizierungsablauf
- Schlüsselentitäten
- Kernlese-/Schreiboperationen
- Paginierung und Ratenbegrenzungen
- Webhook- oder Polling-Modell
3. Bauen Sie in reposnativen Schichten
Typische Schichten:
- Konfiguration/Schema
- Client/Transport
- Mapping-Schicht
- Connector/Provider-Einstiegspunkt
- Registrierung
- Tests
4. Validieren Sie gegen das Quellmuster
Der neue Connector sollte im Codebestand offensichtlich wirken, nicht aus einem anderen Ökosystem importiert.
Referenzstrukturen
Provider-Stil
providers/
existierender_provider/
__init__.py
provider.py
config.py
Connector-Stil
integrations/
existierend/
client.py
models.py
connector.py
TypeScript-Plugin-Stil
src/integrations/
existierend/
index.ts
client.ts
types.ts
test.ts
Qualitäts-Checkliste
- Entspricht einem vorhandenen Integrationsmuster im Repo
- Konfigurationsvalidierung existiert
- Authentifizierung und Fehlerbehandlung sind explizit
- Paginierungs-/Wiederholungsverhalten folgt den Repo-Normen
- Registry-/Discovery-Verdrahtung ist vollständig
- Tests spiegeln den Stil des Host-Repos wider
- Dokumentation/Beispiele werden aktualisiert, falls vom Repo erwartet
Verwandte Fähigkeiten
backend-patternsmcp-server-patternsgithub-ops