Saltar al contenido
Marketplace

api-connector-builder

de affaan-m

ターゲット リポジトリの既存統合パターンに正確に一致する新しい API コネクターまたはプロバイダーを構築します。2 番目のアーキテクチャを発明せずに、1 つ以上の統合を追加するときに使用します。

Resumen

SKILL.mdLeída en ef648e0

API コネクター ビルダー

リポジトリネイティブな統合サーフェスを追加する場合に使用します。汎用 HTTP クライアントではありません。

ポイントはホスト リポジトリのパターンと一致することです:

  • コネクター レイアウト
  • 構成スキーマ
  • 認証モデル
  • エラー処理
  • テスト スタイル
  • 登録/発見ワイヤリング

使用するとき

  • 「このプロジェクトの Jira コネクターを構築する」
  • 「既存のパターンに従う Slack プロバイダーを追加する」
  • 「この API の新しい統合を作成する」
  • 「リポジトリのコネクター スタイルに一致するプラグインを構築する」

ガード レール

  • リポジトリに既に統合アーキテクチャがある場合は、新しい統合アーキテクチャを発明しないでください。
  • ベンダー ドキュメントだけから始めないでください。最初に既存の repo 内コネクターから始めてください。
  • リポジトリがレジストリ ワイヤリング、テスト、およびドキュメントを期待する場合は、トランスポート コードで停止しないでください。
  • リポジトリに新しい現在のパターンがある場合は、古いコネクターをカーゴカルト化しないでください。

ワークフロー

1. ハウス スタイルを学ぶ

少なくとも 2 つの既存のコネクター/プロバイダーを検査して、マップしてください:

  • ファイル レイアウト
  • 抽象化の境界
  • 構成モデル
  • 再試行 / ページネーション コンベンション
  • レジストリ フック
  • テスト フィクスチャと命名
2. ターゲット統合を絞り込む

リポジトリが実際に必要とするサーフェスのみを定義します:

  • 認証フロー
  • キー エンティティ
  • コア読み取り/書き込み操作
  • ページネーションとレート制限
  • Webhook またはポーリング モデル
3. リポジトリネイティブ レイヤーで構築

一般的なスライス:

  • 構成/スキーマ
  • クライアント/トランスポート
  • マッピング レイヤー
  • コネクター/プロバイダー エントリ ポイント
  • 登録
  • テスト
4. ソース パターンに対して検証

新しいコネクターは、別のエコシステムから インポートされたのではなく、コードベースで明白に見えるはずです。

リファレンス シェイプ

プロバイダー スタイル
providers/
  existing_provider/
    __init__.py
    provider.py
    config.py
コネクター スタイル
integrations/
  existing/
    client.py
    models.py
    connector.py
TypeScript プラグイン スタイル
src/integrations/
  existing/
    index.ts
    client.ts
    types.ts
    test.ts

品質チェックリスト

  • [ ] 既存の repo 内統合パターンに一致します
  • [ ] 構成検証が存在します
  • [ ] 認証とエラー処理が明示的です
  • [ ] ページネーション/再試行動作がリポジトリ規範に従います
  • [ ] レジストリ/発見ワイヤリングが完成しました
  • [ ] テストはホスト リポジトリのスタイルを反映しています
  • [ ] ドキュメント/例がリポジトリで期待されている場合は更新されます

関連スキル

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

Archivos 1 archivo

Instálala a mano

Deska ejecuta esto por ti, para cada agente que elijas. Para ejecutarlo tú en una terminal:

npx skills add affaan-m/ecc --skill api-connector-builder

Más de affaan-m

  • docker-patternsaffaan-mDocker and Docker Compose patterns for local development, container security, networking, volume strategies, and multi-service orchestration. Use when setting up containerized development environments or reviewing Docker configurations.4,800 instalaciones en skills.sh0
  • security-reviewaffaan-mUse this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment/sensitive features. Provides comprehensive security checklist and patterns.4,800 instalaciones en skills.sh0
  • backend-patternsaffaan-mBackend architecture patterns, API design, database optimization, and server-side best practices for Node.js, Express, and Next.js API routes. Use when building or reviewing Node.js, Express, or Next.js API routes and their data access.4,700 instalaciones en skills.sh0
  • frontend-patternsaffaan-mFrontend development patterns for React, Next.js, state management, performance optimization, and UI best practices. Use when building or reviewing React or Next.js components, state, or render performance.4,700 instalaciones en skills.sh0
  • coding-standardsaffaan-mBaseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed frontend or backend skills for framework-specific patterns. Use when reviewing code quality or naming with no framework-specific skill that applies.4,500 instalaciones en skills.sh0
Todas las skills de affaan-m