From 1fdbcd63dff7162c29e9ce8b1e52b7271a3a5158 Mon Sep 17 00:00:00 2001 From: Dmitry Dementiev Date: Tue, 4 Aug 2026 21:48:25 +0300 Subject: [PATCH] =?UTF-8?q?docs(skills):=20=D0=BE=D1=82=D0=BA=D1=80=D1=8B?= =?UTF-8?q?=D1=82=D1=8B=D0=B5=20=D0=BD=D0=B0=D1=85=D0=BE=D0=B4=D0=BA=D0=B8?= =?UTF-8?q?=20=D1=85=D0=BE=D0=BB=D0=BE=D0=B4=D0=BD=D0=BE=D0=B3=D0=BE=20?= =?UTF-8?q?=D1=80=D0=B5=D0=B2=D1=8C=D1=8E=20=E2=80=94=20=D1=81=20=D0=BD?= =?UTF-8?q?=D0=BE=D0=BC=D0=B5=D1=80=D0=B0=D0=BC=D0=B8=20=D0=B8=20=D0=B4?= =?UTF-8?q?=D0=BE=D0=B2=D0=BE=D0=B4=D0=BE=D0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - индексы находок жили в скретчпаде и умирают вместе с сессией; из прозы handoff'а нельзя было понять, какая находка закрыта, а какая ещё ждёт решения. - Что: - FIT-5 убрана из списка оставленных: закрыта коммитом 10f55f3. - открытым проставлены номера и довод линии — TECH-3, FIT-4, FIT-11, FIT-12; вопросы владельцу помечены как FIT-3 и FIT-10. - счётчик коммитов заменён командой: HEAD с тех пор уехал. - Проверка: - git log --oneline c18472e.. ; строк длиннее 80 символов в handoff нет. --- ...0260803-kholodnoe-revyu-skilla-i-pravki.md | 44 ++++++++++++------- 1 file changed, 27 insertions(+), 17 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 68ce216..42b98c0 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 @@ -3,8 +3,8 @@ Дата: 2026-08-03/04. Контекст: не боевой прогон, а заход на сам скилл. Начали под `/writing-great-skills` (разбор `references/lessons.md`), закончили под `/brainstorm-with-docs` (холодное ревью и триаж находок). -Диапазон коммитов — `c18472e..HEAD`, девять штук, `git log --oneline` -даёт список; здесь только то, чего в них нет. +Диапазон коммитов — от `c18472e`; список даёт +`git log --oneline c18472e..`. Здесь только то, чего в них нет. ## Холодное ревью: как было устроено и что от него осталось @@ -21,13 +21,13 @@ ## Открытые вопросы к владельцу (не правки) -1. **Две копии определений субагентов.** `references/claude-agents.md` +1. **Две копии определений субагентов** (FIT-3). `references/claude-agents.md` (заготовки) и `.claude/agents/*.md` (созданы коммитом `f650451`). Сегодня совпадают, главная не названа. Расхождение будет тихим: ступень оркестратор читает из первого, харнесс — из второго. -2. **Вкусовую линию нечем эскалировать.** `craftsman` пришит к `medium`, - единственный более сильный Опус (`deep-reasoner`) описан только как - временный фолбэк при отсутствии `craftsman`. При этом разрыв рангов +2. **Вкусовую линию нечем эскалировать** (FIT-10). `craftsman` пришит к + `medium`, единственный более сильный Опус (`deep-reasoner`) описан + только как временный фолбэк при отсутствии `craftsman`. Разрыв рангов «Опус medium против Кодекса high» назван в `lessons.md` причиной, ради которой правились шапки триажа. Вопрос: заводить ли `craftsman` ступенью выше. @@ -40,17 +40,27 @@ ## Находки, оставленные сознательно -- **Отклонена с доводом:** гонка между проверкой отчёта и `wc` в стороже - (микросекунды, а `STALLED` по тексту — повод посмотреть, не вердикт). -- **Оставлены как решение владельца:** формулировки в - `prompts/triage-header.md` про «прогон без отклонений — повод - перечитать» и про NEEDS_DECISION при собственной правке. Обе линия - ревью считает переусердствованием, но текст согласован с владельцем - 2026-08-03 и линия этого не знала. -- **Оставлены после спора:** обоснование переименования рядом с правилом - в `prompt-templates.md` (именно оно удерживает следующего от - «упрощения» имён обратно); стойка «follow it exactly» в начале - определения `craftsman` — территория пользователя. +Всего было 19: 12 по линии уместности (`FIT-*`) и 7 по технической +(`TECH-*`). Закрытые читаются по коммитам диапазона; ниже — открытые, с +номером и доводом, потому что сами индексы живут в скретчпаде и умирают +вместе с сессией. + +- **TECH-3, отклонена с доводом:** гонка между проверкой отчёта и `wc` в + стороже — микросекунды, а `STALLED` по тексту и так повод посмотреть, а + не вердикт. +- **FIT-4, решение владельца:** `prompts/triage-header.md`, «прогон без + единого отклонения — повод перечитать принятое на веру». Довод линии: + базовая статистика отдана тому, кто видит ровно один прогон, и даёт + постоянный повод переоткрывать уже принятое; предлагалось оставить + целевое поведение без статистического обоснования. Текст согласован с + владельцем 2026-08-03, линия этого не знала. +- **FIT-11, оставлена после спора:** девять строк обоснования + переименования встали между сборочным блоком и обёрткой вызова в + `prompt-templates.md`. Оставлено намеренно: именно это обоснование + удерживает следующего от «упрощения» имён обратно. +- **FIT-12, оставлена после спора:** `craftsman.md` открывается стойкой + исполнителя («follow it exactly»), тогда как агента зовут и на слепое + ревью. Территория пользователя. ## Не обкатано боем — проверить первым же прогоном