mcpField
W
webhook-development

webhook-development

github.com/aj-geddes開発373506 回インストール34 週間前に更新
リポジトリ

webhook-development について

イベント駆動型の連携を構築するWebhook開発スキルです。イベント配信、署名検証、再試行、デッドレター処理を扱い、スキーマとNode.js、Pythonのハンドラーガイドを含みます。

主な機能

  1. 01イベント配信パターン
  2. 02署名検証
  3. 03再試行ロジック
  4. 04デッドレター処理
  5. 05スキーマとハンドラーのガイド

活用シーン

  1. 01リアルタイム通知の送信
  2. 02サードパーティープラットフォームとの連携
  3. 03自動ワークフローの起動
  4. 04決済や注文イベントの配信

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill webhook-development

インストール後、Claude Code で/webhook-developmentを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
best-practices.md
nodejs-webhook-service.md
python-webhook-handler.md
webhook-event-schema.md
scripts/
validate-schema.sh
templates/
migration-template.sql

詳細

Webhook 開発

目次

概要

非同期インテグレーション向けに、イベント配信、署名検証、リトライロジック、デッドレター処理を備えた信頼性の高い Webhook システムを構築します。

使用する場面

  • 外部システムにリアルタイム通知を送信する
  • イベント駆動型アーキテクチャを実装する
  • サードパーティプラットフォームと連携する
  • 監査証跡およびログ記録システムを構築する
  • 自動化されたワークフローをトリガーする
  • 決済や注文の通知を配信する

クイックスタート

最小限の動作する例：

{
  "id": "evt_1234567890",
  "timestamp": "2025-01-15T10:30:00Z",
  "event": "order.created",
  "version": "1.0",
  "data": {
    "orderId": "ORD-123456",
    "customerId": "CUST-789",
    "amount": 99.99,
    "currency": "USD",
    "items": [
      {
        "productId": "PROD-001",
        "quantity": 2,
        "price": 49.99
      }
    ],
    "status": "pending"
  },
  "attempt": 1,
  "retryable": true
}

リファレンスガイド

references/ ディレクトリにある詳細な実装：

ガイド内容
Webhook Event SchemaWebhook イベントスキーマ
Node.js Webhook ServiceNode.js Webhook サービス
Python Webhook HandlerPython Webhook ハンドラー
Best Practicesベストプラクティス、Webhook イベント

ベストプラクティス

✅ 推奨事項
  • 確立されたパターンと規約に従う
  • クリーンで保守しやすいコードを書く
  • 適切なドキュメントを追加する
  • デプロイ前に十分にテストする
❌ 避けること
  • テストや検証を省略する
  • エラー処理を無視する
  • 設定値をハードコードする

コメント

Markdown 対応