docs(codex-subagent-playbook): обновлены правила выбора моделей
- Зачем: - уточнены роли моделей и подход к их выбору в конвейере субагентов. - Что: - добавлена матрица цены, интеллекта, вкуса и качества текста. - Terra назначена отправной точкой для технических задач. - дополнены наблюдения о ревью и длительных сессиях Claude. - Проверка: - git diff --cached --check.
This commit is contained in:
1 parent
8999027ea6
commit
ba9f4736ff
4 files changed
+60
-3
No files matched your search
@@ -52,7 +52,7 @@ claude --permission-mode auto --model opus --effort <level> --bg "<mandate>"
|
|||||||
путем. Шумный поток CLI сохрани во временном журнале; координатору верни
|
путем. Шумный поток CLI сохрани во временном журнале; координатору верни
|
||||||
ограниченный индекс и путь к отчету.
|
ограниченный индекс и путь к отчету.
|
||||||
|
|
||||||
Для внешней линии предпочтительно использовать ту же Luna, что и для механических работ.
|
Для внешней линии предпочтительно использовать ту же Terra, что и для механических работ.
|
||||||
Она запускает ревью, следит за ходом работы, получает отчет и готовит краткие
|
Она запускает ревью, следит за ходом работы, получает отчет и готовит краткие
|
||||||
итоги. Для перепроверок продолжает сохраненную сессию до завершения линии.
|
итоги. Для перепроверок продолжает сохраненную сессию до завершения линии.
|
||||||
Храни у нее идентификатор сессии и пути к промпту, журналу и отчету.
|
Храни у нее идентификатор сессии и пути к промпту, журналу и отчету.
|
||||||
@@ -60,7 +60,7 @@ claude --permission-mode auto --model opus --effort <level> --bg "<mandate>"
|
|||||||
Поручай помощнику сопровождение до готового отчета или сбоя, требующего
|
Поручай помощнику сопровождение до готового отчета или сбоя, требующего
|
||||||
решения. Он самостоятельно организует ожидание и продолжает работу после
|
решения. Он самостоятельно организует ожидание и продолжает работу после
|
||||||
обычных промежуточных состояний. Основной канал наблюдения - события среды;
|
обычных промежуточных состояний. Основной канал наблюдения - события среды;
|
||||||
если их нет, повторные проверки примерно раз в минуту выполняются средствами
|
если их нет, повторные проверки примерно раз в 2 минуты выполняются средствами
|
||||||
инструментов, без нового рассуждения модели на каждом интервале. Предел
|
инструментов, без нового рассуждения модели на каждом интервале. Предел
|
||||||
ожидания одного вызова инструмента не задает частоту опроса. Координатор
|
ожидания одного вызова инструмента не задает частоту опроса. Координатор
|
||||||
получает сообщения о существенных изменениях, завершении и вопросах,
|
получает сообщения о существенных изменениях, завершении и вопросах,
|
||||||
@@ -88,3 +88,5 @@ claude --permission-mode auto --model opus --effort <level> --bg "<mandate>"
|
|||||||
|
|
||||||
Если CLI отсутствует или неработоспособен, выбери подходящую свежую линию
|
Если CLI отсутствует или неработоспособен, выбери подходящую свежую линию
|
||||||
Codex и точно назови утраченное преимущество другого семейства моделей.
|
Codex и точно назови утраченное преимущество другого семейства моделей.
|
||||||
|
|
||||||
|
Типичная сессия ревью с Claude может длиться ощутимо дольше 10 минут.
|
||||||
@@ -0,0 +1,51 @@
|
|||||||
|
# Три оси выбора исполнителя: цена, интеллект, вкус
|
||||||
|
|
||||||
|
Эффорт и модель — ручки силы; вкус ими не выражается (прогон #18: код
|
||||||
|
технически безупречен и при этом неправильной формы). Ось вкуса задаёт
|
||||||
|
разрез по подзадачам (этап 1 SKILL.md) и линию уместности ревью
|
||||||
|
(этап 4).
|
||||||
|
|
||||||
|
Матрица — калибровка Тео (@t3dotgg) под его стек, неоднократно актуализирована автором скилла.
|
||||||
|
Числа — порядок, не измерение. `affordability` — практическая
|
||||||
|
доступность лимитов у нас, 9 — почти бесплатно (не публичные цены);
|
||||||
|
`intelligence` — сложность работы, которую можно отдать без надзора;
|
||||||
|
`taste` — суждение в UI/UX, качестве кода, дизайне API, именах и
|
||||||
|
тексте, `literacy` - умение писать аккуратный нарратив текста на русском языке,
|
||||||
|
уместно используюя слова и выражения.
|
||||||
|
|
||||||
|
| модель | affordability | intelligence | taste |literacy
|
||||||
|
| ---------------- | ------------: | -----------: | ----: | ------:
|
||||||
|
| Terra | 9 | ~5 | 5 |6
|
||||||
|
| Sol | 4 | ~9 | 5 |8
|
||||||
|
| Astra | 2 | ~10 | 8 |9
|
||||||
|
| claude-opus-5 | 3 | ~9 | 8 |7
|
||||||
|
| claude-fable-5.1 | 1 | 10 | 9 |8
|
||||||
|
|
||||||
|
## Правила применения
|
||||||
|
|
||||||
|
Оценки — дефолты, не запреты. Разрешение эскалировать без вопроса
|
||||||
|
действует всегда: слабая модель выдала ниже стандарта — повтори более
|
||||||
|
сильной; суди результат, не цену модели.
|
||||||
|
|
||||||
|
- Цена решает только там, где разница в качестве неважна. Для того, что
|
||||||
|
уйдёт в продукт, интеллект и вкус важнее цены.
|
||||||
|
- Всё, что читает человек, пишет модель со вкусом ≥ 7: интерфейсы,
|
||||||
|
проза и продуктовый текст, публичные API и контракты, имена,
|
||||||
|
архитектурные решения, задающие форму системы (в учебном репозитории
|
||||||
|
это почти всё). Дефолт вкусовой части — Опус.
|
||||||
|
- Дешёвые модели собирают, сильные судят: обследование репозитория,
|
||||||
|
чтение объёмов, механика, реализация по жёсткой спеке — дешёвым;
|
||||||
|
результат переносится сильной модели там, где нужно суждение. Токены
|
||||||
|
Fable и Опуса на объёмную работу без суждения не тратить.
|
||||||
|
- Fable держи для самого трудного: оркестрация, архитектура, задачи,
|
||||||
|
где интеллект и вкус нужны одновременно.
|
||||||
|
- Ступень эффорта выбирают по цене *тихой* ошибки этапа, не по его
|
||||||
|
сложности: где ошибка уезжает дальше незамеченной (постановка, ревью,
|
||||||
|
диагноз) — ступень выше; где она падает громко и следующий этап её
|
||||||
|
ловит (реализация, механика) — ниже. Карты ступеней:
|
||||||
|
Claude-субагенты — [claude-agents.md](claude-agents.md), Codex —
|
||||||
|
[codex-exec.md](codex-exec.md).
|
||||||
|
|
||||||
|
Механика вызова: Claude-модели — параметром `model` (Agent/Workflow) и
|
||||||
|
определениями из [claude-agents.md](claude-agents.md); Codex — прямым
|
||||||
|
`codex exec` ([codex-exec.md](codex-exec.md)).
|
||||||
@@ -172,3 +172,7 @@ minimal verification
|
|||||||
Так защита контекста остается ступенчатой: подробности доходят до владельца
|
Так защита контекста остается ступенчатой: подробности доходят до владельца
|
||||||
триажа напрямую, а координатор читает ровно тот уровень, который нужен для
|
триажа напрямую, а координатор читает ровно тот уровень, который нужен для
|
||||||
самостоятельного решения.
|
самостоятельного решения.
|
||||||
|
|
||||||
|
# Особенности ревьюеров
|
||||||
|
|
||||||
|
Sol склонен требовать несоразмерных исходным целям правок.
|
||||||
@@ -32,7 +32,7 @@
|
|||||||
## Модель и глубина
|
## Модель и глубина
|
||||||
|
|
||||||
Модель и глубину рассуждения выбирай независимо, если среда открывает обе
|
Модель и глубину рассуждения выбирай независимо, если среда открывает обе
|
||||||
ручки. Для технических поручений Luna обычная отправная точка - `high`.
|
ручки. Для технических поручений Terra обычная отправная точка - `medium`.
|
||||||
Настройку уточняй по сложности, цене ошибки и предпочтениям пользователя.
|
Настройку уточняй по сложности, цене ошибки и предпочтениям пользователя.
|
||||||
|
|
||||||
Для любой роли существенная неопределенность, необратимое решение или высокая
|
Для любой роли существенная неопределенность, необратимое решение или высокая
|
||||||
|
|||||||
Reference in new issue
Block a user