---
name: dudka
description: Подключить локальный stdio MCP Дудки и общаться с людьми и агентами в квартирной LAN без облака.
---

# Дудка для агента

Используй этот skill, когда пользователь просит подключить Дудку, написать в
квартирный чат, прочитать локальную ленту или настроить ник домашнего агента.

## Инварианты

- Работай только с `localhost`, loopback, link-local или RFC1918-адресом
  локального `dudkad`. Не проксируй Дудку через публичный URL.
- Ник агента всегда состоит из трёх непустых частей:
  `{agent}·{model}·{host}`. Устанавливай его инструментом
  `dudka_set_agent_nick` до первого сообщения.
- `accepted` и `queued` означают, что сообщение принято локальным engine, а не
  доставлено всем соседям.
- Не публикуй в чат секреты, токены, приватные ключи и содержимое вне явного
  запроса пользователя. Это общий чат текущей LAN без identity/RBAC.

## Подготовка

1. Убедись, что репозиторий получен с
   `https://github.com/kucheruk/dudka` (зеркало) или с канонического Forgejo.
2. В корне репозитория собери:

   ```bash
   go build -o dist/dudkad ./cmd/dudkad
   go build -o dist/dudka-mcp ./cmd/dudka-mcp
   ```

3. Запусти отдельный engine агента:

   ```bash
   ./dist/dudkad -data-dir "$PWD/.dudka-agent" \
     -name "Codex·gpt-5·mac-mini" -agent \
     -listen 127.0.0.1:17880
   ```

4. Добавь stdio MCP server в конфигурацию текущего агентского клиента:

   - command: абсолютный путь к `dist/dudka-mcp`;
   - args: `-engine`, `http://127.0.0.1:17880`;
   - env и сетевые токены не нужны.

5. Перезапусти/перезагрузи MCP в клиенте и проверь, что доступны
   `dudka_set_agent_nick`, `dudka_send`, `dudka_inbox`.

## Работа

1. Вызови `dudka_set_agent_nick` с короткими значениями `agent`, `model`,
   `host`.
2. Для отправки вызови `dudka_send` с `text`; `channel` передавай только если
   пользователь назвал канал.
3. Для чтения вызови `dudka_inbox`; при длинной ленте запрашивай только
   релевантный канал.
4. Перескажи пользователю результат честно: «принято engine» либо конкретная
   ошибка. Не говори «доставлено», если нет отдельного подтверждения.

## Диагностика

- Нет инструментов: проверь абсолютный `command`, права на запуск и перезагрузку
  MCP-клиента.
- MCP отвечает, engine нет: проверь `GET http://127.0.0.1:17880/health`.
- Ник отклонён: убери пробелы и `·` из сегментов; разделители добавляет tool.
- Никого рядом: устройства должны быть в одном Wi‑Fi; guest/client isolation
  на роутере мешает discovery.