язык скиллов av-dev-pm: проход упрощения пятью агентами и разбор находок

Эксперимент: по сабагенту на каждый скилл av-dev-pm, задача — переписать текст
более простыми словами, но только там, где уверен и без потери смысла и
точности. Нормой служил устав языка самого проекта, language.md, включая его
раздел «Порог правки»: правка без нарушенного правила не делается.

36 правок в двенадцати файлах, +64/-63 — почти строго замена, а не
переписывание. Правили залог (пассив с названным деятелем в творительном),
отглагольные существительные, параллельность перечней, канцелярит «является»,
пару garden-path и одно двойное отрицание. Контракт не задет нигде: в диффе нет
изменённых строк-заголовков, а код-спаны встречаются ровно парой минус-плюс,
то есть ни имя, ни флаг, ни путь не переписаны.

Отчёты «что рассматривал и не тронул» вышли длиннее отчётов о правках у всех
пятерых, и это главный результат прогона. Самый частый повод остановиться —
слово, живущее в четырёх файлах: конфляция, интейк, провенанс, непоймание.
Правка в одном месте развела бы словарь, а править все — уже не упрощение
текста скилла, а сквозной проход по репозиторию. Второй повод — формулировка,
дословно повторённая в соседнем плагине: декорреляция, материализация
нерешённого, «при расхождении прав текст».

Шестой агент проверил все 36 правок и нашёл четыре.

Перестановка слов в task-research.md развела формулу с её домом: «число без
источника проход ревью обязан читать как условие» стоит в canon.md и в уставе
doc-consistency, который прямо ссылается на канон как на источник. Откачено —
это ровно тот класс расхождения, который сам doc-consistency и ловит.

«Держит H1, мету и индекс в согласии» — управление требует дополнения, а
language.md в разделе англицизмов прямо оговаривает: русский аналог звучит
коряво — остаётся термин. Взят третий вариант, «согласованными».

В skeletons.md «правка тянет запись, и она называет» — местоимение указывает
на два женских существительных сразу. Стало «и запись называет».

Четвёртая находка не откачена: правка в init/SKILL.md хорошая, но развела
конструкцию с близнецом в canon/SKILL.md — выровнена вторая половина.

Побочно найдена старая логическая инверсия в DECISIONS.md, решение U:
«становится неотличимым, только если отрицание обязательно» — смысл вывернут,
в docs/SKILL.md и во второй записи журнала он правильный. Починено.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-08-05 14:49:03 +03:00
co-authored by Claude Opus 5
parent 2d39a77444
commit 47a2f3de63
12 changed files with 64 additions and 63 deletions
+8 -7
View File
@@ -157,9 +157,10 @@ flowchart TD
взятию и залежавшихся; при расхождении раскладки `--fix`.
2. Прочитать `SPRINT.md`: цель, состав, дата начала.
3. **Развилка, и решает её человек.** Набор всё ещё твой — продолжай спринт, ни
сессии, ни переоценки не нужно, они между спринтами. Перечитываешь, зачем эти
задачи собраны вместе, — набор протух: `sprint close --dissolve --reason …`,
недоделанное возвращается в беклог, дальше обычная сессия с шага 1.
сессии, ни переоценки не нужно, они между спринтами. Взялся перечитывать,
зачем эти задачи собраны вместе, — набор протух:
`sprint close --dissolve --reason …`, недоделанное возвращается в беклог,
дальше обычная сессия с шага 1.
Порога в неделях нет намеренно — почему, в
[references/sprint.md](references/sprint.md), «Протухший набор».
@@ -256,8 +257,8 @@ python3 $tk reopen <слаг> --dir D --reason … # приёмка не со
## Слоты проекта
Сессия не знает ни языка, ни сборки, ни CI. Часть проектного отвечает
[канон](../canon/references/canon.md) структурой: разбор процесса (шаг 2) живёт
Сессия не знает ни языка, ни сборки, ни CI. На часть проектного отвечает своей
структурой [канон](../canon/references/canon.md): разбор процесса (шаг 2) живёт
в `docs/review.md`, оракулы и «чем краснеет безусловно» — в семантике гейта в
`CLAUDE.md`. Остальное проект **дописывает в `CLAUDE.md`**:
@@ -272,8 +273,8 @@ python3 $tk reopen <слаг> --dir D --reason … # приёмка не со
это **ориентир, а не закон**.
Слота «куда копируются критерии приёмки» здесь нет намеренно: на него отвечает
**пайплайн проекта**, перенося их в описание изменения при его заведении. Проект
без пайплайна называет своё место сам, в слоте 1.
**пайплайн проекта** — он переносит критерии в описание изменения, когда его
заводит. Проект без пайплайна называет своё место сам, в слоте 1.
Числа проекта (сколько задач в спринте, сколько времени на задачу, каков прирост
беклога) — предмет шага 2, а не константы этого скилла.
+13 -13
View File
@@ -10,7 +10,7 @@
## Шаг 1. Разбор вопросов
`tasks.py list --questions` — всё, что накопилось. Вопрос это решение человека,
и разбирается он **пачкой**, а не по одному в момент возникновения: по одному —
и разбирается он **пачкой**, а не по одному, как только возник: по одному —
это дёрганье, пачкой — это сессия.
Порядок по каждому вопросу:
@@ -21,8 +21,8 @@
2. **Сформулируй развилку** с вариантами и последствием каждого, рекомендация —
первым вариантом.
3. **Вынеси пачкой** через `AskUserQuestion`, не больше трёх за раз.
4. **Ответ записывается в тело задачи, раздел «Вопросы» опустошается**, тег
снимается `edit <slug> --rm-tag question`, **«зачем» переписывается**: «Решено:
4. **Запиши ответ в тело задачи, опустоши раздел «Вопросы»**, сними тег
(`edit <slug> --rm-tag question`), **перепиши «зачем»**: «Решено:
…» на вопрос «почему это лежит в беклоге» уже не отвечает. Опустошение
раздела — не уборка, а условие взятия: правило и причина в скилле `tasks`,
[references/task-format.md](../../tasks/references/task-format.md).
@@ -73,10 +73,10 @@
`CLAUDE.md`. Протухшее и раздвоившееся неотличимо от свежего, и по нему принимают
решения, пока кто-нибудь не наткнётся.
**Пачка — весь канон, и это не расточительство, а охват.** Отбор пачки работой
оставлял без присмотра ровно то, чего работа не касалась: правка, отменившая
решение, живёт в одном документе, а парный статус нужен в другом. Канон мал,
раз в спринт он читается целиком.
**Пачка — весь канон, и это не расточительство, а охват.** Когда пачку отбирала
работа, без присмотра оставалось ровно то, чего работа не касалась: правка,
отменившая решение, живёт в одном документе, а парный статус нужен в другом.
Канон мал, раз в спринт он читается целиком.
Находки обоих — обычный материал переоценки: строка на замену идёт в документ
сразу, работа больше чем на абзац становится задачей типа `chore`. **Позвал —
@@ -138,17 +138,17 @@
задачей, границы вместо реализации в разделе «Затрагивает». Список и правила —
в скилле `tasks`. **Переоценка — то самое место, где беклог добирает тип и
разделы его схемы:** требовать их на входе значило бы выгонять в заметки то,
что должно лежать задачей, а к взятию в спринт они уже обязательны. Сколько
записей готово к взятию, печатает блок здоровья `check`, — по этому числу и
видно, добрала переоценка или нет.
что должно лежать задачей, а к взятию в спринт они уже обязательны. Блок
здоровья `check` печатает, сколько записей готово к взятию, — по этому числу
и видно, добрала переоценка или нет.
Затем — то, что решает пользователь:
6. **Жива ли она вообще.** Контекст мог измениться: ушла зависимость, отпал
сценарий, обошли иначе. Здесь и звучит вопрос о выкидывании.
сценарий, обошли иначе. Здесь и звучит вопрос, выкидывать ли.
7. **Та ли цель — и нужна ли она вообще.** Приоритетов нет, и «повысить» нечего
— вместо повышения **смена цели** (`edit <slug> --goal <другой>`) или
включение в ближайший набор. `feature`, которой не находится цель, — кандидат
— вместо повышения задача **меняет цель** (`edit <slug> --goal <другой>`) или
входит в ближайший набор. `feature`, которой не находится цель, — кандидат
на выход: новая возможность вне цели это возможность, которой никто не
заказывал. Операционной задаче (`fix`, `chore`, `research`) цель не нужна, и
выдумывать её здесь не надо.
@@ -105,10 +105,10 @@ flowchart TD
отвечает «сделано по правилам», критерии — «сделано то, что заказывали».
3. **Находки по ходу отданы списком** — исполнитель обязан их **назвать**
(каждую, с пометкой «заведена / не заведена: причина»), но **не обязан
заводить**: заведение интерактивно, оно требует дедупликации против беклога и
кладбища и решений человека. Обязанность **завести урожай** — на закрытии
спринта, ниже. Так автономный исполнитель не оказывается одновременно обязан
завести задачи и не вправе это сделать в одиночку.
заводить**: заведение интерактивно оно требует дедупликации против беклога
и кладбища, а ещё решений человека. Обязанность **завести урожай** — на
закрытии спринта, ниже. Иначе автономный исполнитель оказался бы разом и
обязан завести задачи, и не вправе сделать это в одиночку.
### Кто и когда закрывает
@@ -132,8 +132,8 @@ flowchart TD
**Само закрытие тоже коммитится, отдельным коммитом.** Удаление файла задачи и
правка индекса — правки в рабочем дереве; пока они не в истории, `SPRINT.md`
ничего не показывает, а `reopen` восстанавливает текст из `HEAD` в узком окне,
которое закончится первым посторонним коммитом. Сообщение про учёт, а не про
ничего не показывает, а `reopen` восстанавливает текст из `HEAD` в узком окне:
его закроет первый посторонний коммит. Сообщение про учёт, а не про
работу: `закрыта задача <slug>`.
**Дорога назад существует и обязана быть названа.** Человек на сессии сверил
@@ -151,7 +151,7 @@ flowchart TD
1. **Критерии переживают файл задачи.** Файл удаляется при закрытии, поэтому
критерии копируются туда, где их увидит приёмщик. Куда именно — **отвечает
пайплайн проекта, а не слот в `CLAUDE.md`**: он переносит их в `tasks.md`
изменения на шаге заведения change. Проект без пайплайна называет своё место
изменения, когда заводит change. Проект без пайплайна называет своё место
сам.
2. **Принимает человек на сессии, а не отдельный агент.** Декорреляция
исполнителя и приёмщика в момент закрытия **снята** (решение о снятии и его