Автоматические комментарии к PR на GitHub через Webhook

SECRET="your-webhook-secret-here"
BODY='{"action":"opened","number":99,"pull_request":{"title":"Test PR","body":"Adds a feature.","user":{"login":"testuser"},"head":{"ref":"feat/x"},"base":{"ref":"main"},"html_url":"https://github.com/org/repo/pull/99"},"repository":{"full_name":"org/repo"}}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print "sha256="$2}')

curl -s -X POST http://localhost:8644/webhooks/github-pr-review \
  -H "Content-Type: application/json" \
  -H "X-GitHub-Event: pull_request" \
  -H "X-Hub-Signature-256: $SIG" \
  -d "$BODY"
# Ожидаемый результат: {"status":"accepted","route":"github-pr-review","event":"pull_request","delivery_id":"..."}

tail -f "${HERMES_HOME:-$HOME/.hermes}/logs/gateway.log"
```:::примечание
`hermes webhook test <name>` работает только для **динамических подписок**, созданных с помощью `hermes webhook subscribe`. Он не читает маршруты из `config.yaml`.</div>
---

## Фильтрация по действиям

GitHub отправляет события `pull_request` для многих действий: `opened`, `synchronize`, `reopened`, `closed`, `labeled` и т.д. Список `events` фильтруется только постепенно заголовку `X-GitHub-Event` — он не может фильтровать по подтипу действия на уровне маршрутизации.

Подсказка в Шаге 1 уже обрабатывает это, предписывая агенту при наступлении события «закрыто» и «помечено».<div class="admonition admonition-warning"><p class="admonition-title">⚠️ Warning</p> Агент всё запускается и расходует токены
Инструкция «остановиться здесь» содержит содержательное ревью, но агент всё равнозначен до конца для каждого события `pull_request` независимо от действия. Вебхуки GitHub может фильтровать только по типам событий («pull_request», «push», «issues» и т.д.) — не по подтипу действия («opened», «closed», «labeled»). Фильтра на уровне маршрутизации по условиям нет. Для репозиториев с высокой активностью примите эту стоимость или отфильтруйте вышестоящим образом с помощью рабочего процесса GitHub Actions, который условно показывает ваш URL-адрес вебхука.</div>
> Синтаксис Jinja2 или условных шаблонов отсутствует. `{field}` и `{nested.field}` — единственные выгодные подстановки. Всё остальное передаётся агенту как есть.

---

## Использование навыка для единообразного стиля ревью

Загрузите [навык Hermes](/docs/user-guide/features/skills), чтобы дать агенту единообразную персону ревьюера. Добавьте `skills` в ваш маршрут внутри `platforms.webhook.extra.routes` в `config.yaml`:
```yaml
platforms:
  webhook:
    enabled: true
    extra:
      routes:
        github-pr-review:
          secret: "your-webhook-secret-here"
          events: [pull_request]
          prompt: |
            A pull request event was received (action: {action}).
            PR #{number}: {pull_request.title} by {pull_request.user.login}
            URL: {pull_request.html_url}

            If the action is "closed" or "labeled", stop here and do not post a comment.

            Otherwise:
            1. Run: gh pr diff {number} --repo {repository.full_name}
            2. Review the diff using your review guidelines.
            3. Write a concise, actionable review comment and post it.
          skills:
            - review
          deliver: github_comment
          deliver_extra:
            repo: "{repository.full_name}"
            pr_number: "{number}"

# Внутри platforms.webhook.extra.routes.<имя-маршрута>:

# Slack
deliver: slack
deliver_extra:
  chat_id: "C0123456789"   # ID канала Slack (опустите, чтобы использовать настроенный домашний канал)

# Discord
deliver: discord
deliver_extra:
  chat_id: "987654321012345678"  # ID канала Discord (опустите, чтобы использовать домашний канал)

events:
  - Merge Request Hook

platforms:
  webhook:
    enabled: true
    extra:
      host: "0.0.0.0"         # адрес привязки (по умолчанию: 0.0.0.0)
      port: 8644               # порт прослушивания (по умолчанию: 8644)
      secret: ""               # опциональный глобальный запасной секрет
      rate_limit: 30           # запросов в минуту на маршрут
      max_body_bytes: 1048576  # ограничение размера полезной нагрузки в байтах (по умолчанию: 1 МБ)

      routes:
        <имя-маршрута>:
          secret: "required-per-route"
          events: []            # [] = принимать все; иначе список значений X-GitHub-Event
          prompt: ""            # {field} / {nested.field} подставляются из полезной нагрузки
          skills: []            # загружается первый подходящий навык (только один)
          deliver: "log"        # log | github_comment | telegram | discord | slack | signal | sms
          deliver_extra: {}     # repo + pr_number для github_comment; chat_id для остальных