ddadmin
51f65b2471
- Зачем: - Скилл поддерживает выбранную пользователем модель координатора, включая Sol. - Что: - Вступление и описание интерфейса адресованы ответственному координатору. - Sol и Terra указаны как обычные исполнители с выбором глубины по сложности. - Приведены в соответствие роли, шаблон поручения и текущие вопросы журнала. - Проверка: - Проверены YAML, явное включение скилла, 60 относительных ссылок и якоря. - Пройден git diff --check; сверены полномочия координатора и исполнителя.
126 lines
7.0 KiB
Markdown
126 lines
7.0 KiB
Markdown
# Мандаты и файловый обмен
|
|
|
|
Читай этот файл, когда готовишь поручение агенту или передаешь большой материал
|
|
между участниками. Смысл ревью и триажа задает
|
|
[единый договор](review-and-triage.md); здесь находятся короткие заготовки.
|
|
|
|
## Выбор канала
|
|
|
|
Ясное поручение, уточнение или вердикт передавай коротким сообщением. Файл
|
|
нужен, когда материал велик, используется повторно или должен попасть от одного
|
|
агента к другому, не проходя целиком через контекст координатора.
|
|
|
|
Для файлового обмена выбери общий временный каталог задачи. Дай каждому
|
|
результату уникальный абсолютный путь с версией артефакта и линией обзора в
|
|
имени. Получатель читает исходный файл напрямую; координатор передает путь и
|
|
короткую цель, не копирует полный материал в новый промпт.
|
|
|
|
Постоянные английские блоки находятся в [prompts/](prompts/):
|
|
|
|
- [result-contract.md](prompts/result-contract.md) - ограниченный результат
|
|
исполнителя, исследователя или проверяющего;
|
|
- [review-boilerplate.md](prompts/review-boilerplate.md) - мандат и формат
|
|
независимого обзора;
|
|
- [triage-header.md](prompts/triage-header.md) - разбор находок реализации;
|
|
- [recheck-header.md](prompts/recheck-header.md) - узкая перепроверка;
|
|
- [runtime-language.md](prompts/runtime-language.md) - язык временного обмена.
|
|
|
|
## Короткое поручение
|
|
|
|
Если задача ясна из текущего контекста, достаточно такого сообщения:
|
|
|
|
```text
|
|
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.
|
|
```
|
|
|
|
Убирай ненужные строки. Не создавай обменный файл ради нескольких предложений.
|
|
|
|
## Большое поручение
|
|
|
|
В параметрическом файле оставь только факты конкретной задачи:
|
|
|
|
```text
|
|
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
|
|
```
|
|
|
|
Если агенту нужен полный отчет, передай ему пути к
|
|
[договору результата](prompts/result-contract.md) и
|
|
[правилу языка](prompts/runtime-language.md) либо механически собери эти файлы
|
|
с параметрами. Координатор не перепечатывает постоянные блоки. Передай агенту
|
|
короткое сообщение с путем к поручению. Сборка файлов служит оптимизацией для
|
|
длинного материала.
|
|
|
|
## Исполнитель Sol или Terra
|
|
|
|
Ограничь поручение так, чтобы контекста исполнителя хватало на реализацию,
|
|
проверки и исправления. К короткому или большому поручению Sol или Terra
|
|
добавь блок:
|
|
|
|
```text
|
|
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.
|
|
```
|
|
|
|
## Независимое ревью
|
|
|
|
Параметры обзора должны назвать:
|
|
|
|
```text
|
|
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
|
|
```
|
|
|
|
Передай пути к этим параметрам, [мандату ревьюера](prompts/review-boilerplate.md)
|
|
и [правилу языка](prompts/runtime-language.md) либо механически собери из них
|
|
полное поручение.
|
|
Каждая линия получает свой фокус, префикс и путь. Отчеты параллельных линий не
|
|
передаются друг другу до завершения исходных обзоров.
|
|
|
|
Для проверки формы можно добавить такой фокус:
|
|
|
|
```text
|
|
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.
|
|
```
|
|
|
|
## Разбор и перепроверка
|
|
|
|
Исполнитель разбирает реализацию по
|
|
[triage-header.md](prompts/triage-header.md). Передай ему пути к подробным
|
|
отчетам без изменений, решения координатора и уникальный путь резолюций.
|
|
Короткая сводка ревьюера не заменяет исходные доказательства.
|
|
|
|
Исходному ревьюеру для узкой перепроверки передай
|
|
[recheck-header.md](prompts/recheck-header.md), путь к его исходному отчету,
|
|
путь к резолюциям, границу новой версии, нужные проверки и новый уникальный
|
|
путь отчета. Продолжи тот же тред или сессию: здесь его прежний контекст
|
|
полезен.
|
|
|
|
В каждом файловом варианте агент возвращает короткий индекс и путь. Полный
|
|
отчет остается доступен следующему владельцу работы без пересказа координатором.
|