ddadmin
3a72ce906f
- Зачем: - Актуализирована координация под Astra с сохранением замысла и бюджета контекста. - Что: - Разделены роли Astra, Sol и Luna; выбор приемов оставлен координатору. - Сохранены независимое ревью, триаж и проверка соразмерности исправлений. - Обновлены нативные механики и необязательная линия Claude CLI. - Проверка: - Проверены Markdown-ссылки, YAML и git diff --check; описано ограничение валидатора. - Пройден поведенческий сценарий с тремя тестами и независимое ревью Claude. - Перепроверены находки и фактическое продолжение фоновой сессии Claude.
110 lines
6.2 KiB
Markdown
110 lines
6.2 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) либо механически собери эти файлы
|
|
с параметрами. Координатор не перепечатывает постоянные блоки. Передай агенту
|
|
короткое сообщение с путем к поручению. Сборка файлов служит оптимизацией для
|
|
длинного материала.
|
|
|
|
## Независимое ревью
|
|
|
|
Параметры обзора должны назвать:
|
|
|
|
```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), путь к его исходному отчету,
|
|
путь к резолюциям, границу новой версии, нужные проверки и новый уникальный
|
|
путь отчета. Продолжи тот же тред или сессию: здесь его прежний контекст
|
|
полезен.
|
|
|
|
В каждом файловом варианте агент возвращает короткий индекс и путь. Полный
|
|
отчет остается доступен следующему владельцу работы без пересказа координатором.
|