av/dev-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

вычитку зовёт тот, кто правил, а не тот, кто синкал

Browse Source 
Вычитка документов была привязана к синку, а разведка синком себя не считает —
и не доставалась ей вовсе. Условие вызова теперь правка: правил документы —
зови doc-wording, трогал записи — task-form и task-wording.

У разведки вычитка стала шагом 6, между записью и гейтом: пачка собирается из
шагов 4 и 5, раньше она не полна, после коммита правила бы уже историю. Гейт
с коммитом стал седьмым шагом, закрытие — восьмым.

Запрет остался, но только на судей канона: doc-consistency и doc-code-drift
идут на весь канон разом и зовутся через healthcheck.
This commit is contained in:
av
2026-08-11 13:37:33 +03:00
parent b3479776a4
commit f22e7ed829
6 changed files with 110 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
av-dev-docs/skills/docs/SKILL.md
+14 -9
View File
@@ -77,16 +77,21 @@ description: Вести содержимое документов канона
## Вычитка — наоборот, здесь
**Язык правленого вычитывается на синке, и зовёшь агента `doc-wording` ты.**
Довод обратный доводу про судей: он читает **только названную пачку**, стоит
дёшево и ищет ровно то, что портится в момент письма, — залог, оценку без факта,
жаргон, термин без ввода. Ждать `healthcheck` здесь нечего: через месяц никто уже
не помнит, какую фразу имел в виду автор.
**Язык правленого вычитывается тем же прогоном, который его написал, и зовёшь
агента `doc-wording` ты.** Довод обратный доводу про судей: он читает **только
названную пачку**, стоит дёшево и ищет ровно то, что портится в момент письма, —
залог, оценку без факта, жаргон, термин без ввода. Ждать `healthcheck` здесь
нечего: через месяц никто уже не помнит, какую фразу имел в виду автор.
Позови его **последним шагом синка**, отдав список файлов, которых чек-лист
коснулся, — и назови этот список в промпте: по нему же он судит, известен ли
термин. Ничего не правивший синк агента не зовёт. Находки он отдаёт готовыми
формулировками, подставляешь их ты.
Позови его **последним шагом правки, до коммита**, отдав список файлов, которых
она коснулась, — и назови этот список в промпте: по нему же он судит, известен ли
термин. Находки он отдаёт готовыми формулировками, подставляешь их ты.
**Условие вызова — правка, а не синк.** Синк самый частый вызывающий, но не
единственный: разведка (`av-dev-code:resolve`, сценарий разведки) пишет ответ по
одному адресу и синком себя не считает намеренно — вычитка ей нужна ровно та же.
Признак один и читается буквально: **документы правились — зови, ничего не правил
— не зови**.
## ADR — промоут, а не второе сочинение