diff --git a/agents/.agents/skills/codex-subagent-playbook/SKILL.md b/agents/.agents/skills/codex-subagent-playbook/SKILL.md index 44959b7..54be506 100644 --- a/agents/.agents/skills/codex-subagent-playbook/SKILL.md +++ b/agents/.agents/skills/codex-subagent-playbook/SKILL.md @@ -113,3 +113,6 @@ Claude добавляет взгляд другого семейства; его Покажи, что оказалось полезным, где были лишние затраты и какие ограничения остались. Глубину отчета выбирай по масштабу работы; для короткого прогона достаточно нескольких предложений. + +Если прогон дал новое существенное наблюдение или ты дорабатываешь скилл +по опыту работы, обратись к [эмпирике и правилам ее хранения](references/lessons.md). diff --git a/agents/.agents/skills/codex-subagent-playbook/references/lessons-archive.md b/agents/.agents/skills/codex-subagent-playbook/references/lessons-archive.md new file mode 100644 index 0000000..bcbf708 --- /dev/null +++ b/agents/.agents/skills/codex-subagent-playbook/references/lessons-archive.md @@ -0,0 +1,67 @@ +# Архив эмпирики: июль 2026 + +Перенесено 2026-09-06 после переработки скилла под Astra. Ниже дословно +сохранен прежний файл с наблюдениями 2026-07-10–2026-07-23 и тогдашними +вопросами. Его инструкции, назначения моделей и ограничения среды относятся +к прежней редакции. Текущие вопросы и порядок ведения журнала находятся в +[lessons.md](lessons.md). + +--- + +# Эмпирика прогонов + +Храни здесь только датированные факты, которые меняют выбор приёма, и живые +гипотезы. Поглощённый урок сжимай до строки с указателем на действующий +договор. Правь этот долговечный файл только после согласования с партнёром. + +## Наблюдения + +- 2026-07-10 — хост скрыл выбор роли и модели; стоимость осталась + незакреплённой. Исследователь нашёл блокирующий `.gitignore`, но без нужды + запустил полный набор тестов. Вывод поглощён в + [основную оптику](../SKILL.md) и [роли](roles.md). +- 2026-07-10 — главной утечкой контекста была повторная передача отчётов и + промптов через координатора. Вывод поглощён в + [правила обмена](../SKILL.md) и [сборку промптов](prompt-templates.md). +- 2026-07-12 — разные семейства ревьюеров пересеклись в двух темах примерно из + восьми и сохранили заметный независимый вклад. Вывод поглощён в + [договор ревью](review-and-triage.md). +- 2026-07-12 — самоприменение поймало сломанную сборку с необязательным + `notes.md` и показало, что язык обмена надо задавать явно. Вывод поглощён в + [сборку промптов](prompt-templates.md). +- 2026-07-12 — второй ревьюер того же семейства не дал новой родословной; + координатор вывел в свой контекст 44 хэша, полный отчёт и почти весь diff; + права ревьюера смешались с каналом результата; семь буквальных этапов + породили лишние проверки. Вывод поглощён в + [основную оптику](../SKILL.md) и [договор ревью](review-and-triage.md). +- 2026-07-23 — сверка с клодовским близнецом (claude-subagent-playbook): + перенесены проверенные его прогонами правила — одно ревью на версию + артефакта, саморевью исполнителя и сквозная проверка до внешних линий, + партнёр в петле (в [основную оптику](../SKILL.md)); цена тихой ошибки + как критерий уровня и проверка внешних фактов первоисточником + (в [роли](roles.md)). +- 2026-07-23 — по опыту партнёра хост принимает `reasoning_effort` + субагента, но фактически не применяет его; действующая ручка уровня — + модель и TOML-роль. Кавеат внесён в [роли](roles.md); снять после + починки хоста. + +## Проверить боем + +1. Удерживает ли Sol оптику тонкого мастера: что больше всего расходует + контекст координатора и можно ли направить это через файл или субагента. +2. Достаточна ли Luna `medium` для простой ограниченной реализации и + подтверждается ли, что `low` даёт слишком много повторной работы. +3. Окупается ли Terra `medium` на узком обзоре постановки и проверке + реализации по задаче. +4. Сходится ли обычная реализация на Sol `medium`, а сложная — на Sol + `high`, с меньшей общей стоимостью петли. +5. Оправдан ли ручной `xhigh` хоть в одном классе задач; текущая гипотеза — + штатно переходить от `high` сразу к `max` только по сильному триггеру. +6. Остаётся ли дерево неизменным после ревьюера с `workspace-write` и явным + мандатом сохранять результат только в назначенный отчёт. +7. Доступны ли ревьюеру поиск и документация при текущих сетевых разрешениях. +8. Достаточно ли файлового канала, чтобы координатор не открывал полный + отчёт, diff и сырые журналы. +9. Может ли будущая линия другого семейства читать и писать общий + `$SCRATCH`. Пока адаптер запуска не проверен, он не является действующим + договором. diff --git a/agents/.agents/skills/codex-subagent-playbook/references/lessons.md b/agents/.agents/skills/codex-subagent-playbook/references/lessons.md index 622841b..1bdce1b 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/lessons.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/lessons.md @@ -1,57 +1,46 @@ # Эмпирика прогонов -Храни здесь только датированные факты, которые меняют выбор приёма, и живые -гипотезы. Поглощённый урок сжимай до строки с указателем на действующий -договор. Правь этот долговечный файл только после согласования с партнёром. +Здесь остаются наблюдения, влияющие на ближайшие решения, и открытые +вопросы. Обращайся к ним при разборе похожего случая или доработке скилла. -## Наблюдения +## Как поддерживать журнал -- 2026-07-10 — хост скрыл выбор роли и модели; стоимость осталась - незакреплённой. Исследователь нашёл блокирующий `.gitignore`, но без нужды - запустил полный набор тестов. Вывод поглощён в - [основную оптику](../SKILL.md) и [роли](roles.md). -- 2026-07-10 — главной утечкой контекста была повторная передача отчётов и - промптов через координатора. Вывод поглощён в - [правила обмена](../SKILL.md) и [сборку промптов](prompt-templates.md). -- 2026-07-12 — разные семейства ревьюеров пересеклись в двух темах примерно из - восьми и сохранили заметный независимый вклад. Вывод поглощён в - [договор ревью](review-and-triage.md). -- 2026-07-12 — самоприменение поймало сломанную сборку с необязательным - `notes.md` и показало, что язык обмена надо задавать явно. Вывод поглощён в - [сборку промптов](prompt-templates.md). -- 2026-07-12 — второй ревьюер того же семейства не дал новой родословной; - координатор вывел в свой контекст 44 хэша, полный отчёт и почти весь diff; - права ревьюера смешались с каналом результата; семь буквальных этапов - породили лишние проверки. Вывод поглощён в - [основную оптику](../SKILL.md) и [договор ревью](review-and-triage.md). -- 2026-07-23 — сверка с клодовским близнецом (claude-subagent-playbook): - перенесены проверенные его прогонами правила — одно ревью на версию - артефакта, саморевью исполнителя и сквозная проверка до внешних линий, - партнёр в петле (в [основную оптику](../SKILL.md)); цена тихой ошибки - как критерий уровня и проверка внешних фактов первоисточником - (в [роли](roles.md)). -- 2026-07-23 — по опыту партнёра хост принимает `reasoning_effort` - субагента, но фактически не применяет его; действующая ручка уровня — - модель и TOML-роль. Кавеат внесён в [роли](roles.md); снять после - починки хоста. +При согласованном обновлении добавляй существенный новый случай: дату, +модель и среду, наблюдаемый результат, основание вывода и открытый вопрос, +если он остался. Отделяй наблюдение от предполагаемой причины. Повтор +известного случая заслуживает записи, когда добавляет свидетельство или +меняет вывод. Подробный отчет прогона остается в материалах задачи. -## Проверить боем +Усвоенное правило живет в основном тексте, справочнике или мандате по месту +применения. В журнале достаточно указателя на него рядом с исходным случаем. +Изменение правил и выводов согласуй с партнером; сохраняй ранее полученное +разрешение в его границах. -1. Удерживает ли Sol оптику тонкого мастера: что больше всего расходует - контекст координатора и можно ли направить это через файл или субагента. -2. Достаточна ли Luna `medium` для простой ограниченной реализации и - подтверждается ли, что `low` даёт слишком много повторной работы. -3. Окупается ли Terra `medium` на узком обзоре постановки и проверке - реализации по задаче. -4. Сходится ли обычная реализация на Sol `medium`, а сложная — на Sol - `high`, с меньшей общей стоимостью петли. -5. Оправдан ли ручной `xhigh` хоть в одном классе задач; текущая гипотеза — - штатно переходить от `high` сразу к `max` только по сильному триггеру. -6. Остаётся ли дерево неизменным после ревьюера с `workspace-write` и явным - мандатом сохранять результат только в назначенный отчёт. -7. Доступны ли ревьюеру поиск и документация при текущих сетевых разрешениях. -8. Достаточно ли файлового канала, чтобы координатор не открывал полный - отчёт, diff и сырые журналы. -9. Может ли будущая линия другого семейства читать и писать общий - `$SCRATCH`. Пока адаптер запуска не проверен, он не является действующим - договором. +После существенной смены скилла, моделей или среды, а также когда старые +записи затрудняют поиск живых вопросов, перенеси завершенный период в +[архив](lessons-archive.md). Сохрани текст случаев без пересказа и укажи +границу переноса. Сначала оставь здесь актуальные нерешенные вопросы с +указателями на исходные свидетельства; устаревшие предположения остаются +частью истории. Архив открывай для конкретного случая, нужного доказательства +или проверки происхождения правила. + +## Проверить на обычных задачах + +- Удерживает ли Astra полезный объем контекста: какие подробности нужны для + самостоятельного решения, а какие повторно проходят через координатора + без пользы? Продолжение июльских вопросов об обмене из + [архива](lessons-archive.md#проверить-боем). +- Когда переиспользование исполнителя и помощь Luna сокращают повторную + работу, а когда прежний контекст или расходы на делегирование мешают? +- Помогает ли триаж Sol сохранять соразмерность исправлений после нескольких + кругов ревью? Нужны случаи с основаниями принятых и отклоненных находок. + +Эти вопросы уточнены 2026-09-06 для новой редакции. Наблюдай их там, где +обычная задача дает материал; отдельные сравнительные прогоны требуют +собственной цели и оправданной стоимости. + +## Граница архива + +2026-09-06 июльский файл целиком сохранен в [архиве](lessons-archive.md). +Его прежние ограничения ролей и глубины не задают текущий запуск: для этого +служат [возможности среды](roles.md) и [механика Claude](claude.md).