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

Аддон Herdr

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

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

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

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

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

Стабилен начиная с v1.0.0. Публичный интерфейс следует семантическому версионированию: глаголы CLI и их документированные флаги, коды выхода 0–7, документированные переменные HERDR_PEERS_*, DWP_PLAN и DWP_TASK, протокол 1, а также JSON-контракты herdr-peers/lanes-v1, herdr-peers/lead-v1 и запись делегирования. Несовместимое изменение любого из них повышает мажорную версию, а изменение формата передачи также повышает номер протокола. v1.0.0 не меняет никакого поведения по сравнению с v0.3.3, и релизы 0.x больше не поддерживаются.

Установка

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

npx --yes skills add https://github.com/DailybotHQ/herdr-peers/tree/v1.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-агентом.

Контейнеры и хост

С аддоном devcontainer на devcontainer-kit v1.1.1 каждый контейнер dck поставляется с herdr-peers и присоединяется к сети при dck up: его агенты могут обращаться к агентам на хосте, в других контейнерах и в других loopback-контейнерах хоста и получать ответ. dck setup устанавливает проверенный herdr-peers на хост, поэтому агенты хоста тоже отвечают. Listener на хосте и дополнительные ключи, которые впускают другие контейнеры, — ваши решения в профиле хоста kit; этот аддон никогда их не задаёт. Начиная с herdr-peers (v0.2.3), каждая машина хранит собственное состояние ($XDG_STATE_HOME/herdr-peers/<server>/), поэтому рабочая копия, общая для хоста и контейнера, больше не смешивает их записи, а начиная с devcontainer-kit (v0.3.3) контейнер сам экспортирует HERDR_PEERS_SELF, так что агенты Codex внутри него обращаются к другим машинам без ручных шагов.

Herdr или agentkit

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

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

Если ведущий агент ведёт множество линий одновременно — панели на хосте, в контейнерах и на других машинах, каждая на собственной учётной записи, — herdr-peers lanes показывает каждую линию с её состоянием, herdr-peers status <pane> классифицирует экран, на котором стоит заблокированная линия, а каждая запись делегирования называет учётную запись и поставщика, которые её выполнили. См. Запуск множества агентов.

Каждый лейн называет свою панель. Согласно правилам автономии роя (Guide §17.2), каждый лейн передает свою панель с помощью в каждом глаголе herdr-peers (, , , , , , ), чтобы предотвратить ошибочную атрибуцию сообщений и насыщение слотов. Лейны Codex требуют этого особенно строго из-за общего фонового сервера между сессиями.

Уведомления и лидерство

herdr-peers (v0.3.2) добавляет то, что позволяет рою пережить своего ведущего агента (Автономия роя):

  • Уведомления. herdr-peers notify <addr|lead> "<text>" --pane <pane> отправляет одностороннее сообщение со штампом reply=no. check получателя классифицирует его как уведомление, записывает как данные и никогда не отвечает. Уведомления не занимают слот fan-out и могут отправляться, пока открыт запрос; используйте их для объявлений о передаче работы, смене ведущего агента и рассылок о релизах.
  • Запись ведущего агента для каждого плана. herdr-peers lead claim --plan <P> --succession <A,B> --lanes <A,B> делает агента ведущим одного плана; lead show выводит запись (схема herdr-peers/lead-v1: план, ведущий агент, эпоха, порядок преемственности, линии, время обновления). lead handover <addr> --plan <P> передаёт лидерство, lead takeover --plan <P> позволяет первому доступному заместителю принять его, когда ведущий агент пропал, а lead release --plan <P> завершает его. Каждое изменение повышает эпоху и уведомляет каждую линию. Делайте claim плана до запуска его линий: lead разрешается, только когда запись существует. Начиная с v0.3.2 запись хранит локально репозиторий, сделавший claim, и отклоняет claim того же id плана из другого репозитория; называйте такой план --plan <repo>/<id>.
  • Ограждение (fencing). Линия принимает уведомление ведущего агента только от агента, который дал ей задание (первый claim), от текущего ведущего агента на следующей эпохе (handover) или от первой доступной записи в порядке преемственности на следующей эпохе (takeover). Всё остальное записывается и игнорируется, а вернувшийся ведущий агент, который видит более высокую эпоху, уходит в сторону.
  • Адрес lead. ask lead … и notify lead … разрешаются в текущего ведущего агента плана --plan (иначе $DWP_PLAN), поэтому ни одно задание линии не прописывает панель ведущего агента жёстко.
  • Экраны usage_limit. status и lanes распознают сообщение CLI о лимите использования как класс экрана usage_limit, следующий шаг для которого — передача работы. На него никогда не отвечают клавишами. lanes --json добавляет план, его ведущего агента, эпоху и последний сообщённый запас каждой линии.

Линии также могут спрашивать друг друга об информации и координации — интерфейс, имя флага, состояние ветки, — но работу назначает только ведущий агент. Глубина 1 и ограничение fan-out по-прежнему действуют. В v0.2.x нет ни уведомлений, ни записей ведущего агента: линии отправляют запросы по адресу ведущего агента из своего задания, а о смене ведущего агента сообщает разработчик.

Дебаты

herdr-peers 1.1.0 добавляет встроенный подскилл debate (debate.md): ведущий агент проводит панель пиров в панелях Herdr через раунды и завершает её одним результатом, которому человек может доверять, вместе с доказательствами и особыми мнениями. Используйте его только тогда, когда человек просит дебаты, панель, красную команду, исследование силами нескольких агентов или с нескольких точек зрения либо вторую панель по результату; мнение одного агента — это один ask.

  • Сначала цель. Ведущий выбирает цель — решить, исследовать современное состояние области, провести стресс-тест, проверить или сгенерировать — и у каждой свои форматы, свой подсчёт и свой итоговый документ. Цели можно выстраивать в цепочку (исследовать → решить, решить → проверить), а масштаб дебатов бывает быстрым, стандартным или глубоким.
  • Обязательства ведущего. Ведущий никогда не голосует; слова человека переносятся дословно; брифы попадают к панели по одному каналу; каждая панель записывает позицию на диск и отвечает одной строкой; ни одна панель не совершает внешних действий.
  • Форматы. Исследование по ракурсам, классические раунды, пакет черновика, перекрёстный допрос по каждому утверждению, сначала красная команда, потом защитники, сначала steelman, потом суждение, слепой вызов со свежим контекстом, панель репликации и расходящиеся предложения. Решение всегда завершается заданным набором вердиктов.
  • Команда herdr-peers debate. tally подсчитывает ранжированные бюллетени и вердикты по пунктам (Борда, Копленд, попарные дуэли, победитель и проигравший по Кондорсе); claims сводит реестры утверждений от линий в статусы вроде «установлено», «оспаривается» или «опровергнуто» — это кворум, а не проверка; anon копирует позиции под анонимными именами, а соответствие хранит в закрытом ключе; filings перечисляет поданные, отсутствующие и слишком короткие позиции, чтобы повторно опрашивать только недостающие панели.
  • Состав панели. panel предлагает панель и ничего не запускает. Места распределяются по кругу между поставщиками моделей, а внутри поставщика первым идёт место с наибольшей квотой — из свободных панелей и, если установлен agentkit (ak), из аккаунтов, которые предлагает ak pick. Без ak рекомендуется coding-agents-kit (необязательно, v1.0.1 или новее).
  • Шаблоны. Шестнадцать шаблонов в templates/debate/ — от заметки человека и брифов исследования, стресс-теста и раундов до файлов бюллетеней и утверждений, пакета передачи дел ведущего и записей решения, состояния области, стресс-теста и репликации.
  • Доставка заблокированному пиру. reply и notify повторяют доставку пиру, остановившемуся на вопросе, до --wait-blocked секунд; ответ по-прежнему ровно один.

Релиз только дополняет: протокол 1 и все команды, флаги, коды выхода и JSON-контракты не меняются.

Примечания

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