chore: убраны рабочие заметки перед слиянием в master
- Зачем: - Рабочая зона .scratch не переносится в master по правилам репозитория. - Что: - Удалены спецификация и отчет проверки из текущего дерева ветки. - Ссылки на их версии в истории сохранены в актуальном handoff скилла. - Проверка: - Сверены состав .scratch и доступность обеих версий документов в Git.
This commit is contained in:
ddadmin committed
1 parent
f49b5847f9
commit
f36111660d
2 files changed
-227
No files matched your search
@@ -1,160 +0,0 @@
|
||||
# Переработка codex-subagent-playbook
|
||||
|
||||
## Задача
|
||||
|
||||
Пересобрать скилл как дополнительную оптику для Astra-координатора:
|
||||
сохранять смысл задачи, выбирать полезное делегирование, беречь дорогой
|
||||
контекст и принимать результат. Скилл можно добавить посреди работы;
|
||||
координатор применяет подходящие приёмы к текущему состоянию задачи.
|
||||
|
||||
Текущий скилл вырос из Claude-плейбука, развивался отдельно и позднее получил
|
||||
ссылку на него как на базовый. В нём смешались прежние ограничения среды,
|
||||
повторяющиеся правила и разные шкалы ревью. По опыту пользователя, Sol
|
||||
склонен выполнять формальные требования, принимать замечания ревью за истину
|
||||
и усложнять решение после нескольких кругов исправлений. Проход на вычитание
|
||||
появился как защита от этого поведения.
|
||||
|
||||
## Принятый подход
|
||||
|
||||
Основной текст даёт координатору способы оценивать ситуацию: где нужно его
|
||||
суждение, кому поручить работу, какой контекст сохранить, что проверить и
|
||||
когда свидетельств достаточно. Постановка, исследование, реализация, ревью,
|
||||
триаж, перепроверка и проход на вычитание остаются доступными приёмами.
|
||||
Координатор выбирает их состав и порядок по пользе для задачи. Подключение
|
||||
скилла само по себе не создаёт обязательных этапов или повторных проверок.
|
||||
|
||||
У выбранного приёма есть ясный договор. Например, независимое ревью требует
|
||||
свежего контекста, а триаж — явного исхода каждой находки. Эти свойства
|
||||
сохраняют смысл приёма. Правила владения изменениями защищают совместную
|
||||
работу агентов. Остальные рекомендации оставляют место суждению координатора.
|
||||
|
||||
### Роли и внимание координатора
|
||||
|
||||
| Участник | Назначение |
|
||||
|---|---|
|
||||
| Astra | Замысел, подход, границы, технический вкус, разрешение спорных вопросов и приёмка |
|
||||
| Sol | Основная реализация, техническое исследование, проверка и исправление подтверждённых дефектов |
|
||||
| Luna | Понятная механика, пакетные операции и известные проверки с объёмным выводом |
|
||||
| Claude | Преимущественно независимое ревью другим семейством моделей для поиска слепых зон GPT |
|
||||
|
||||
Это распределение ответственности, а не обязательный список участников.
|
||||
Sol свободен в локальных технических решениях. Вопрос, который существенно
|
||||
меняет устройство решения, границы или добавляет обязательства, возвращается
|
||||
координатору с вариантами, последствиями и рекомендацией.
|
||||
|
||||
Astra сохраняет контекст пользовательского замысла и читает достаточно
|
||||
ключевых фрагментов, чтобы самостоятельно судить о результате. Объёмное
|
||||
исследование, журналы и механика остаются у субагентов. Экономия контекста
|
||||
не должна лишать координатора оснований для решения; подробности раскрываются
|
||||
по мере необходимости.
|
||||
|
||||
Короткое поручение, вопрос или вердикт передаются сообщением. Большой материал,
|
||||
который нужен другому агенту, передаётся напрямую через файл; координатору
|
||||
достаточно выжимки и пути. Вывод инструментов сокращается до нужных фактов
|
||||
до попадания в его контекст. Файл оправдан защитой контекста и дальнейшим
|
||||
использованием материала, а не самим фактом обмена между агентами.
|
||||
|
||||
### Ревью и отдельный триаж
|
||||
|
||||
Claude полезен различием обучения и самостоятельным взглядом на код. Его
|
||||
доступность не гарантирована: основной процесс работает средствами Codex,
|
||||
а отсутствие Claude само по себе не требует согласования. Выбор конкретной
|
||||
модели опирается на результаты прогонов; прежняя оценка Opus не становится
|
||||
постоянной гарантией качества.
|
||||
|
||||
Свежая Astra допустима для ревью нетривиальных решений: устройства,
|
||||
соразмерности и оправданности новых сущностей и зависимостей. Координатор
|
||||
оценивает пользу такого обзора с учётом стоимости. Свежесть контекста и
|
||||
различие семейств — самостоятельные основания выбора ревьюера. Приёмка
|
||||
координатором с контекстом разговора сохраняет отдельную роль.
|
||||
|
||||
Триаж остаётся самостоятельной работой с находками. Находки о постановке
|
||||
разбирает координатор. При ревью реализации исполнитель проверяет
|
||||
технические утверждения и обосновывает исправление либо отклонение.
|
||||
Координатор разбирает противоречия, уместность сложности и решения в пределах
|
||||
согласованной задачи. Изменения цели, границ и существенный остаточный риск
|
||||
выносятся пользователю.
|
||||
|
||||
У каждой находки есть явный исход: исправлена, отклонена, вынесена за границы
|
||||
или требует решения. Исправления перепроверяются, отклонения подкрепляются
|
||||
доводами. Вынесенный вопрос остаётся открытым до решения его владельца.
|
||||
Сохраняется связь между исходной находкой, её разбором и перепроверкой.
|
||||
|
||||
Повтор спора без новых доказательств, разрастание исправлений и падение пользы
|
||||
очередного обзора — признаки несходимости. Координатор пересматривает подход
|
||||
и при необходимости выносит развилку пользователю. Третий и пятый круги
|
||||
остаются практическими ориентирами в справочнике; основание вмешательства —
|
||||
состояние задачи, а не обязательное прохождение заданного числа кругов.
|
||||
|
||||
Ревью — набор проверяемых утверждений. При разборе важны фактическая верность,
|
||||
применимость сценария к проекту и соразмерность исправления. Предложенный
|
||||
ревьюером способ починки тоже оценивается; исполнитель может выбрать более
|
||||
подходящий. Аргументированное отклонение нормально, квота отклонений не нужна.
|
||||
Например, требование усилить безопасность должно опираться на применимый
|
||||
сценарий и конкретную границу доверия. Само упоминание безопасности не делает
|
||||
предложение обязательным.
|
||||
|
||||
Проход на вычитание сохраняется как приём против накопления лишнего после
|
||||
реализации и ревью. Координатор оценивает, какие добавления по-прежнему
|
||||
оправданы задачей. Выбранные удаления сохраняют нужное поведение, изменившаяся
|
||||
часть получает подходящую проверку. Универсальное правило «при сомнении режь»
|
||||
уступает оценке конкретного решения.
|
||||
|
||||
### Среда и устройство скилла
|
||||
|
||||
Запуск ревьюеров и достаточность их доступа контролирует Astra. Согласованный
|
||||
полноценный запуск Claude нельзя молча подменять ограниченным запуском и
|
||||
засчитывать его как выполненное ревью. Полноценный доступ включает нужные для
|
||||
обзора тесты, исследование, сеть и временные файлы. Сохранность исходников
|
||||
и постоянного окружения задаётся мандатом ревьюера; ограничение доступа
|
||||
только чтением не заменяет этот мандат. При реальном ограничении координатор
|
||||
сообщает конкретную причину и решает, как продолжить в доступных условиях.
|
||||
|
||||
Новый скилл опирается на доступные средства выбора модели, глубины рассуждения
|
||||
и передачи истории. Июльские утверждения об ограничениях требуют проверки.
|
||||
Описание параметра инструментом и его фактическое применение различаются;
|
||||
проверенные возможности и оставшиеся предположения должны быть различимы.
|
||||
|
||||
Структуру определяет [writing-for-agents](../../agents/.agents/skills/writing-for-agents/SKILL.md):
|
||||
общая оптика находится в основном тексте, механика отдельных приёмов — по
|
||||
ссылкам с ясными условиями чтения. Один смысл имеет одно авторитетное место.
|
||||
Конкретные настройки среды отделены от устойчивых принципов. Границы
|
||||
обязательной работы сформулированы проверяемо, без лишних ритуалов.
|
||||
|
||||
## Границы и альтернативы
|
||||
|
||||
Полная переработка самостоятельного Codex-скилла предпочтительнее точечной
|
||||
починки надстройки: надстройка сохраняет чтение двух расходящихся инструкций.
|
||||
Claude-плейбук служит источником проверенных приёмов; его полное чтение
|
||||
перестаёт быть предпосылкой применения нового скилла.
|
||||
|
||||
Общий слой для двух плейбуков сейчас не является целью: он расширяет работу
|
||||
за пределы настройки координации Astra. Обязательный конвейер также отклонён:
|
||||
пользователь применяет скиллы как оптику для сильного агента и ожидает выбора
|
||||
действий по пользе для задачи. Оставить всё как есть означало бы сохранить
|
||||
наблюдавшиеся сбои. Переработка Claude-плейбука в эту задачу не входит.
|
||||
|
||||
## Как оценить результат переработки
|
||||
|
||||
Поведение нового скилла нужно проверить на характерных ситуациях:
|
||||
|
||||
- При подключении посреди работы координатор выбирает нужные приёмы,
|
||||
сохраняя силу уже выполненной работы и проверок.
|
||||
- Механическая задача не порождает лишних участников и этапов; нетривиальное
|
||||
решение получает достаточное внимание Astra и обоснованное ревью.
|
||||
- Большой отчёт попадает нужному агенту, а координатор получает основания
|
||||
для решения без повторного чтения полного материала.
|
||||
- Ошибочная или неуместная находка получает обоснованный исход; настоящая
|
||||
проблема исправляется и проверяется. Все находки учтены отдельно.
|
||||
- Повторяющийся спор без новых доказательств вызывает пересмотр подхода,
|
||||
а не автоматический запуск ещё одного общего ревью.
|
||||
- Исправление, которое добавляет существенную сложность, получает оценку
|
||||
уместности до внесения; проход на вычитание сохраняет нужное поведение.
|
||||
- При недоступности Claude работа продолжается доступными средствами;
|
||||
ограничения проведённой проверки названы точно.
|
||||
- Выбор моделей, глубины рассуждения и передачи истории опирается на
|
||||
проверенные возможности среды, а не на старые заметки.
|
||||
|
||||
Конкретные настройки моделей и способы запуска уточняются при переработке.
|
||||
Эта спецификация сохраняет согласованное направление; изменение самого
|
||||
скилла начинается по отдельному запросу на реализацию.
|
||||
@@ -1,67 +0,0 @@
|
||||
# Проверка переработанного плейбука
|
||||
|
||||
Дата: 2026-09-06. Спецификация зафиксирована коммитом `65c802f`.
|
||||
|
||||
## Что проверено
|
||||
|
||||
Основной текст и справочники сверены с принятой спецификацией. Astra сохраняет
|
||||
замысел и приемку, Sol ведет реализацию и технический триаж, Luna выполняет
|
||||
ограниченную механику. Выбор ревью и канала обмена остается ситуативным.
|
||||
Механики Claude больше не требуют чтения его отдельного плейбука.
|
||||
|
||||
Детерминированные проверки прошли:
|
||||
|
||||
- `git diff --check`;
|
||||
- 46 относительных Markdown-ссылок, включая 8 ссылок с якорями;
|
||||
- разбор YAML, длина `short_description`, наличие имени скилла в подсказке;
|
||||
- сохранение явного включения: `disable-model-invocation: true` и
|
||||
`allow_implicit_invocation: false`.
|
||||
|
||||
Штатный `quick_validate.py` не знает существующее поле
|
||||
`disable-model-invocation` и отклоняет исходник. На временной копии с удалением
|
||||
только этого поля он возвращает `Skill is valid!`. Исходное поле сохранено для
|
||||
мостов между инструментами; успешная проверка копии не выдается за успешную
|
||||
прямую проверку исходника.
|
||||
|
||||
## Поведение и независимое ревью
|
||||
|
||||
Свежая Astra получила изолированную задачу с настоящим дефектом и спорными
|
||||
находками ревью. Она исправила обработку нулевого приоритета, добавила
|
||||
регрессионную проверку, отклонила ненужное усиление безопасности и вынесла
|
||||
расширение архитектуры за границы задачи. Координатор подтвердил сохранение
|
||||
границ. Проверка нового случая сначала падала, после исправления все три теста
|
||||
прошли; координатор повторил их. Это один ограниченный сценарий, а не оценка
|
||||
общей эффективности скилла. Независимой перепроверки кода этого примера не было.
|
||||
|
||||
Реализацию скилла проверил Claude CLI с `--permission-mode auto`. Метаданные
|
||||
подтвердили `claude-opus-5` и `high`. Пользователь явно разрешил передачу diff и
|
||||
фрагментов кода этому каналу ревью; после этого автоматическая проверка
|
||||
разрешила ранее отклоненный запуск.
|
||||
|
||||
Из девяти находок Claude восемь исправлены. Требование удалить исторические
|
||||
заметки отклонено: они не входят в обязательное чтение и не задают текущую
|
||||
механику. Дополнительно исправлена находка координатора: отклонение чрезмерного
|
||||
способа починки не закрывает подтвержденный дефект.
|
||||
|
||||
Узкая перепроверка в продолжении контекста исходного ревью дала `APPROVED`:
|
||||
8 `CLOSED`, 1 `REJECTION_VALID`, без новых дефектов и `OVERREACH`.
|
||||
Хеши всех 15 файлов до и после обоих обзоров совпали.
|
||||
|
||||
## Проверка запуска
|
||||
|
||||
Схема нативных инструментов подтверждает выбор модели, глубины и истории.
|
||||
Полная история наследует модель и глубину; явные переопределения требуют
|
||||
свежего или ограниченного контекста. Принятый параметр сам по себе не доказывает
|
||||
фактически примененную глубину рассуждения.
|
||||
|
||||
Claude CLI 2.1.263 показал дополнительную особенность: повторное задание
|
||||
параметров при `--resume` создает копию даже завершенной сессии. Поэтому первая
|
||||
перепроверка продолжила историю в копии. Пример в справочнике исправлен на
|
||||
`claude --bg --resume <session-id> "<поручение>"` без переопределений.
|
||||
Следующий запуск подтвердил тот же идентификатор и сохраненные настройки
|
||||
доступа, модели и глубины. Ревьюер отдельно одобрил эту последнюю поправку;
|
||||
хеши исходников после проверки не изменились.
|
||||
|
||||
Исторические handoffs, `lessons.md`, принятая спецификация и посторонние
|
||||
неотслеживаемые каталоги не изменены. Временные отчеты и пробный код оставлены
|
||||
в `/tmp/codex-playbook-refactor.dW8ZC3`; они не являются частью скилла.
|
||||
Reference in new issue
Block a user