From 28f9e6fdd915fc395370a571f20572d421873b73 Mon Sep 17 00:00:00 2001 From: Dmitry Dementiev Date: Tue, 4 Aug 2026 21:53:40 +0300 Subject: [PATCH] =?UTF-8?q?docs(skills):=20=D1=83=D1=80=D0=BE=D0=BA=20?= =?UTF-8?q?=D0=BF=D1=80=D0=BE=20=D0=B7=D0=B0=D0=BF=D1=80=D0=B5=D1=82-?= =?UTF-8?q?=D0=B7=D0=BD=D0=B0=D1=87=D0=B5=D0=BD=D0=B8=D0=B5=20=D0=B8=20?= =?UTF-8?q?=D0=BF=D0=BE=D0=B4=D1=8A=D1=91=D0=BC=20=D1=81=D0=BA=D1=80=D0=B5?= =?UTF-8?q?=D1=82=D1=87=D0=BF=D0=B0=D0=B4=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - три случая одной формы за месяц: правило стоит на месте, а рассуждение берёт себе исключение — отказ стоит описать до того, как он повторится в четвёртый раз. - Что: - запись 2026-08-04 в lessons.md: песочница ревьюера и лечение значением, восстановление скретчпада из транскрипта сессии с ценой и границами приёма, диагноз владельца про краткость исполнителя. - третий открытый вопрос handoff'а закрыт решением владельца и заменён ссылкой на журнал. - Проверка: - git log --oneline c18472e.. ; новых строк длиннее 80 символов нет. --- ...0260803-kholodnoe-revyu-skilla-i-pravki.md | 8 ++--- .../references/lessons.md | 35 +++++++++++++++++++ 2 files changed, 37 insertions(+), 6 deletions(-) diff --git a/agents/.agents/skills/claude-subagent-playbook/handoffs/20260803-kholodnoe-revyu-skilla-i-pravki.md b/agents/.agents/skills/claude-subagent-playbook/handoffs/20260803-kholodnoe-revyu-skilla-i-pravki.md index 42b98c0..73d8aaf 100644 --- a/agents/.agents/skills/claude-subagent-playbook/handoffs/20260803-kholodnoe-revyu-skilla-i-pravki.md +++ b/agents/.agents/skills/claude-subagent-playbook/handoffs/20260803-kholodnoe-revyu-skilla-i-pravki.md @@ -31,12 +31,8 @@ «Опус medium против Кодекса high» назван в `lessons.md` причиной, ради которой правились шапки триажа. Вопрос: заводить ли `craftsman` ступенью выше. -3. **Записывать ли в уроки случай с песочницей.** Правило «не режь - ревьюеру read-only» стояло в двух местах и было нарушено при сборке - команды для этого же холодного ревью — не по незнанию, а рассуждением - («ревью документа рук не требует»). Вылечено значением, а не третьим - запретом (коммит `f481831`). Владелец решает сам, идёт ли это в - журнал. +Третий вопрос — про случай с песочницей — решён 2026-08-04: записан в +`lessons.md` вместе с двумя прежними случаями той же формы. ## Находки, оставленные сознательно diff --git a/agents/.agents/skills/claude-subagent-playbook/references/lessons.md b/agents/.agents/skills/claude-subagent-playbook/references/lessons.md index 7909779..ea957de 100644 --- a/agents/.agents/skills/claude-subagent-playbook/references/lessons.md +++ b/agents/.agents/skills/claude-subagent-playbook/references/lessons.md @@ -298,3 +298,38 @@ рядом с приёмом в `codex-exec.md`; старьё — ранжирование правил задачи (07-07), эхо файла задачи (07-13), A/B на gpt-5.6-terra (07-13), пп. 1–2 и 4 одёргиваний (07-31). + +## 2026-08-04: находки холодного ревью долечены; запрет против значения + +Сессия без прогона, продолжение 08-03: триаж находок холодного ревью самого +скилла. Что именно поправлено — в коммитах от `c18472e`, здесь не дублирую. + +- **Правило, нарушаемое рассуждением, лечится значением, а не ещё одним + запретом.** «Не режь ревьюеру read-only» стояло в двух местах — и было + нарушено при сборке команды для этого же холодного ревью: не по + незнанию, а доводом «ревью документа рук не требует». Промпт при этом + сам обещал ревьюеру опыты во временных файлах, которые песочница + запрещала, — тред пришлось убить и перезапустить. Вылечено тем, что + песочница названа значением с причиной при нём, а ветке ревьюера дан + целый рецепт: не осталось повода собирать команду руками. +- **Случай третий той же формы** (два прежних в архиве: 07-22 канал + обёртки, 07-30 `danger-full-access` «на всякий случай» из-за оговорки + «боем не обкатано»). Отказ скилла — не отсутствующее правило, а правило, + оставляющее рассуждению право на исключение; оговорка в рецепте читается + как приглашение к самодеятельности. +- **Скретчпад поднимается из транскрипта сессии.** Ребут стёр каталог; + шесть документов восстановлены fast-worker'ом из JSONL сессии + (`~/.claude/projects/<проект>/.jsonl`): вызовы Write отдают тело + дословно, файлы чужих процессов — из эха Read с обрезкой номеров строк. + Не поднимаются промпты, ушедшие в `cat ... |` на stdin: их тело в + транскрипт не попадало. Цена — 48k токенов субагента, три минуты. +- **Вывод под этим**: пережить сессию должно то, что лежит вне скретчпада. + Индексы находок целиком не переносим — в handoff идут открытые, с + номером и доводом линии; закрытые читаются по коммитам. +- **Диагноз пользователя: краткость исполнителя ломает решение.** Метку + NEEDS_DECISION ставит тот, кто единственный держит код в голове, а + наверх уходит голый вопрос — координатор кода не читал по устройству + ролей, владелец тем более. Дословно: «Опус пишет так, как будто я очень + хорошо разбираюсь в коде и проблеме, а так бывает далеко не всегда». + Отсюда требование вариантов, их цены и рекомендации — и к исполнителю, и + к координатору, когда он несёт развилку владельцу.