ddadmin
8fe848a65d
- Зачем: - сократить лишние обращения к координатору при ожидании ревью и передаче материалов. - Что: - уточнены оценка объема Git и трекерных операций, самостоятельное ожидание и прямой файловый обмен. - сохранены предпочтения владельца по отдельному помощнику для Claude и передаче материалов. - добавлено предпочтение Opus для независимого ревью с заменой на Astra при недоступности. - Проверка: - проверены локальные ссылки и git diff --check. - штатный валидатор до и после правок отклоняет существующий ключ disable-model-invocation; режим вызова сохранен.
8.7 KiB
Мандаты и файловый обмен
Читай этот файл, когда готовишь поручение агенту или передаешь большой материал между участниками. Смысл ревью и триажа задает единый договор; здесь находятся короткие заготовки.
Выбор канала
Ясное поручение, уточнение или вердикт передавай коротким сообщением. Файл нужен, когда материал велик, используется повторно или должен попасть от одного агента к другому, не проходя целиком через контекст координатора.
Для файлового обмена выбери общий временный каталог задачи. Дай каждому результату уникальный абсолютный путь с версией артефакта и линией обзора в имени. Полные отчеты и разбор находок остаются в файлах; сообщения между участниками передают путь, проверяемую версию и следующий шаг. При назначении назови отправителя и получателя, чтобы они могли продолжать обмен напрямую. Координатор получает короткий итог и вопросы, требующие его суждения.
Постоянные английские блоки находятся в prompts/:
- result-contract.md - ограниченный результат исполнителя, исследователя или проверяющего;
- review-boilerplate.md - мандат и формат независимого обзора;
- triage-header.md - разбор находок реализации;
- recheck-header.md - узкая перепроверка;
- runtime-language.md - язык временного обмена.
Короткое поручение
Если задача ясна из текущего контекста, достаточно такого сообщения:
Goal: <one verifiable outcome>.
Scope: <allowed files, state, or question>.
Read: <only required paths>.
Check: <relevant command or evidence>.
Return: <concise result, or unique report path when the payload is large>.
Escalate design or scope changes with options, costs, and your recommendation.
Убирай ненужные строки. Не создавай обменный файл ради нескольких предложений.
Большое поручение
В параметрическом файле оставь только факты конкретной задачи:
GOAL: one verifiable outcome
WORKING DIRECTORY: absolute path
BOUNDARIES: allowed work and protected state
READ FIRST: exact paths
CHECKS: commands or hypotheses
REPORT: unique absolute path
Если агенту нужен полный отчет, передай ему пути к договору результата и правилу языка либо механически собери эти файлы с параметрами. Координатор не перепечатывает постоянные блоки. Передай агенту короткое сообщение с путем к поручению. Сборка файлов служит оптимизацией для длинного материала.
Исполнитель Sol или Terra
Ограничь поручение так, чтобы контекста исполнителя хватало на реализацию, проверки и исправления. К короткому или большому поручению Sol или Terra добавь блок:
You may delegate bounded mechanical support to Luna, reusing a suitable
existing helper when its context is useful. You remain responsible for the
result and for preventing conflicting writes within your assigned scope.
Escalate any need for another implementer at the Sol or Terra level to the
coordinator, who decides how to split and assign the work. If the task outgrows
your available context, raise that while there is still room to explain the
remaining work.
Если для задачи уместен TDD, укажи в поручении скилл /tdd по имени,
ожидаемое поведение и уже согласованные границы проверки.
Независимое ревью
Параметры обзора должны назвать:
TITLE: short review title
WORKING DIRECTORY: absolute path
STATEMENT: task and governing contract paths
REVIEWED VERSION: commit, prepared diff, exact paths, or other stable boundary
FOCUS: one explicit lens
OUT OF SCOPE: unrelated work
CHECKS: useful commands and expected observations
FINDING PREFIX: unique stable prefix
REPORT: unique absolute path
Для внешнего канала после уже полученного разрешения добавь точную границу:
TRANSFER: <exact materials and channel already authorized by the user>
Передай пути к этим параметрам, мандату ревьюера и правилу языка либо механически собери из них полное поручение. Каждая линия получает свой фокус, префикс и путь. Отчеты параллельных линий не передаются друг другу до завершения исходных обзоров.
Для проверки формы можно добавить такой фокус:
Before reading the changes, sketch one plausible solution shape from the
statement: responsibilities, boundaries, data movement, and necessary
artifacts. This is a hypothesis, not a prescribed design. Compare the actual
shape with it, identify decisions left open by the statement, and judge each
decision against repository values, risk, and task proportion.
Если линия оценивает структуру и сопровождаемость кода, добавь этот фокус.
Названия запахов взяты из /code-review Мэтта Покока (Фаулер, Refactoring,
гл. 3):
Use Fowler's code smells as prompts for judgment: Mysterious Name,
Duplicated Code, Feature Envy, Data Clumps, Primitive Obsession,
Repeated Switches, Shotgun Surgery, Divergent Change, Speculative Generality,
Message Chains, Middle Man, Refused Bequest.
Treat them as heuristics; documented repository conventions take precedence.
For a finding, explain the maintenance consequences in this project and
judge the proposed remedy against those costs and the task's scope.
Разбор и перепроверка
Исполнитель разбирает реализацию по triage-header.md. Ревьюер или сопровождающий его помощник передает исполнителю пути к полным отчетам и уникальный путь резолюций; координатор добавляет свои решения, когда они нужны. Короткая сводка ревьюера не заменяет исходные доказательства.
Для узкой перепроверки исполнитель передает исходному ревьюеру напрямую или через его помощника recheck-header.md, путь к исходному отчету, путь к резолюциям, границу новой версии, нужные проверки и новый уникальный путь отчета. Перепроверка продолжается в том же треде или сессии: здесь прежний контекст ревьюера полезен.
В каждом файловом варианте агент возвращает короткий индекс и путь. Полный отчет остается доступен следующему владельцу работы без пересказа координатором.