Skip to content
← Назад к набору

Аддон Herdr

Herdr размещает агентов для программирования в панелях — на вашей машине и на машинах, до которых он дотягивается по SSH. Этот аддон позволяет Deep Work Plan использовать этих агентов как peer-агентов: план может передать ограниченную задачу агенту в другой панели, получить ровно один авторизованный ответ и сохранить запись этого обмена.

Это опциональный аддон DWP v7 (v7.0.0). Методология работает так же и без него: если аддон отсутствует или отключён, каждая задача выполняется в текущей сессии, как и раньше.

Что он интегрирует

Аддон — тонкий интегратор. Работу выполняет herdr-peers — самостоятельный навык под лицензией MIT, закреплённый на v0.1.0 и полезный и без Deep Work Plan. Он определяет то, что сам Herdr оставляет открытым: кто может отвечать, как ответ возвращается между машинами, как двум агентам избежать бесконечных ответов друг другу и где хранится запись «я спросил, он ответил».

Элемент Значение
Продукт DailybotHQ/herdr-peers, тег v0.1.0, протокол 1
Ключ реестра herdr в .dwp/config.json
Транспорт интерактивный: peer-агент в панели Herdr
Предоставляет subagents, cancel_children
Требует разрешения agent_delegation в контракте плана

Установка

Установите herdr-peers и официальный навык Herdr, от которого он зависит. Каждой машине, агенты которой должны отвечать, этот навык тоже нужен.

npx --yes skills add https://github.com/DailybotHQ/herdr-peers/tree/v0.1.0 --skill herdr-peers -g -y
npx --yes skills add https://github.com/herdrdev/herdr/tree/v0.9.3 --skill herdr -g -y

Требования: Herdr 0.9.1 или новее, bash и python3 3.9 или новее (только стандартная библиотека). Онбординг предлагает аддон и фиксирует ваш ответ в реестре аддонов; без согласия он никогда не включается.

Что он добавляет в план

  • Делегирование peer-агенту. В плане v7, контракт которого предоставляет agent_delegation, execute может передать задачу parallel_safe или вопрос только для чтения агенту в другой панели — на этой или другой машине.
  • Один авторизованный ответ. Запрос несёт штамп, который авторизует ровно один ответ. Peer-агент отвечает один раз через helper, и ответ несёт собственный штамп.
  • Запись до использования. Каждое делегирование записывается в analysis_results/delegations.ndjson плана до того, как ответ будет использован, и соответствует событию журнала v7 delegation.
  • Результаты остаются утверждениями до проверки. Ответ peer-агента является доказательством asserted, пока собственный gate runner плана его не зафиксирует. Он никогда сам не закрывает задачу.

Модель безопасности

Правило Что оно означает
Сначала разрешение Делегирование выполняется только тогда, когда контракт плана предоставляет agent_delegation.
Лимит глубины 1 На сообщение со штампом depth=1 или reply-to= никогда не отвечают, а делегат никогда не делегирует дальше.
Ограничение fan-out По умолчанию не более четырёх peer-агентов на одного инициатора.
Данные, а не инструкции Ответ никогда не даёт полномочий, которых у получателя ещё не было.
Один писатель на путь Peer-агент, который пишет, работает в собственном git worktree.

herdr-peers не аутентифицирует отправителя: поле from= в штампе — лишь утверждение. Мерой защиты служит allow-list HERDR_PEERS_SCOPE, который ограничивает рабочие пространства и машины, принимаемые peer-агентом.

Herdr или agentkit

Оба аддона реализуют один и тот же интерфейс делегирования — launch, observe, collect, cancel — с разными транспортами.

Ситуация Использовать
Ограниченная задача parallel_safe с объявленным результатом agentkit (headless ak run в worktree)
Задача требует взаимодействия, выполняется долго или находится на другой машине Herdr (peer-агент в панели)

Примечания

Опционален и никогда не обязателен. Репозиторий без опциональных аддонов полностью соответствует требованиям, и ни один поток не зависит от этого аддона. Полный цикл между двумя панелями и машинами покрыт тестами на симулированном Herdr; запланируйте первый запуск под наблюдением.