# webhook-platform-design

Помогает спроектировать платформу исходящих вебхуков: таксономию событий, подпись HMAC, повторные доставки и журнал отладки.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 8100 установок · ★ 7
- Автор: Samuel Berthe
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/samber/developer-platform-skills/tree/HEAD/skills/webhook-platform-design/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/webhook-platform-design

## Что делает

Скилл превращает агента в проектировщика провайдерской стороны вебхуков. Он разбирает, какие события платформа рассылает клиентским серверам, как устроен конверт payload и версионирование схемы, как подписывать запросы по Standard Webhooks и как гарантировать доставку хотя бы один раз с повторами, backoff и очередью недоставленных сообщений. Отдельно прорабатывается жизненный цикл подписок и то, чем интегратор отлаживает потерянную доставку: журнал, повтор и отправка тестового события.

Перед проектированием скилл задаёт уточняющие вопросы пачкой: greenfield или доработка существующего, порядок масштаба по числу эндпоинтов и пиковой частоте событий, типы потребителей, потолок по ресурсам и ограничения на передачу данных, срок запуска. Ответы на последние два вопроса важны, потому что от них зависит выбор между собственной реализацией, self-hosted шлюзом и управляемой инфраструктурой отправки — меню вариантов и график повторов расходятся по времени до результата и трудозатратам.

Скилл работает только со стороны провайдера. Механику повторов на стороне потребителя он не трогает — для этого есть `samber/developer-platform-skills@api-idempotency-retry`. Сквозной обзор всех поверхностей API — задача `samber/developer-platform-skills@public-api-design-review`, а выбор между вебхуками и другими формами интеграции — `samber/developer-platform-skills@api-integration-surface-strategy`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-platform-skills --skill webhook-platform-design -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/webhook-platform-design/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/webhook-platform-design/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-platform-skills --skill webhook-platform-design -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/webhook-platform-design/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-platform-skills --skill webhook-platform-design -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/webhook-platform-design/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install samber/developer-platform-skills webhook-platform-design
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/webhook-platform-design/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-platform-skills --skill webhook-platform-design -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/samber/developer-platform-skills --path skills/webhook-platform-design
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/webhook-platform-design/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-platform-skills --skill webhook-platform-design -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/samber/developer-platform-skills/tree/HEAD/skills/webhook-platform-design/SKILL.md

## Когда брать
- спроектировать каталог событий и версионирование схемы payload
- выбрать схему подписи HMAC и защиту от повторного воспроизведения запроса
- настроить повторные доставки с backoff и политикой недоставленных сообщений
- описать состояния жизненного цикла подписки
- собрать журнал доставок с повтором и отправкой тестового события

## Примеры запросов агенту
- Спроектируй платформу исходящих вебхуков для нашего API: каталог событий, конверт payload и подпись по Standard Webhooks
- Продумай повторные доставки с backoff и dead-letter для вебхуков, потребители — типичные API-разработчики
- Что положить в журнал доставок, чтобы интегратор мог повторить событие и отправить тестовое?

## Похожие
- [sent-webhook-engineer](https://affpapa.org/nevibecode/skills/sent-webhook-engineer.md) — скилл · 2700 установок
- [webhook-development](https://affpapa.org/nevibecode/skills/webhook-development.md) — скилл · 504 установки
- [webhook-integration](https://affpapa.org/nevibecode/skills/webhook-integration.md) — скилл · 1100 установок
- [encore-webhook](https://affpapa.org/nevibecode/skills/encore-webhook.md) — скилл · 418 установок
- [github-webhooks](https://affpapa.org/nevibecode/skills/github-webhooks.md) — скилл · 487 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md