вычитка ревью: пережитки трёх плагинов и язык слияния
Восемнадцать веток «плагина нет» описывали недостижимое: скиллы и агенты теперь в одном плагине и разрешаются всегда. Где предмет всё же может отсутствовать — ветка переписана на след в проекте (нет docs/, нет каталога задач, нет openspec/); где отсутствовать нечему — снята. Туда же анонсы, обещавшие ветку, которой в разделе больше нет. Правило копий и его применение разъезжались в одном коммите: правило называло два законных случая, а absence.md разослан семью копиями по SKILL.md. Назван третий случай, и разрез проверяемый — файл, который модель получает целиком, против файла, за которым она идёт отдельным чтением. Заодно сняты объявления копий там, где копию сменила ссылка, и довод у карты домов в doc-consistency: он ссылался на отсутствие плагина, хотя устав едет вместе с плагином. Описания скиллов во фронтматтерах звали снятые короткие имена — по ним скилл не находится. task-track перестал обещать повышение: версию двигает doc-canon. Язык: сняты кросс-вызов, опцион и деградация, конверсия и «читатель» в config.py, charter'ы против уставов, замер против подсчёта, страдательный залог в журнале. Строка «настройки av-dev» в таблице отсутствия — слово «раскладка» называло и целое, и его часть. Мелкое: тема 52 в README была 64, транслит в task-wording машина не проверяет, мёртвая ветка REQUIRED в addresses.py, ссылки на язык в закрытом журнале.
This commit is contained in:
@@ -9,10 +9,10 @@
|
||||
|
||||
## Плагины
|
||||
|
||||
Плагина два: **av-dev** — весь процесс, и **av-dev-git** — сообщения коммитов,
|
||||
работающие в любом репозитории. До 13 августа 2026 процесс жил тремя плагинами
|
||||
Плагина два: **av-dev** — весь процесс, и **av-dev-git** — сообщения коммитов.
|
||||
Второй работает в любом репозитории, в том числе не приведённом к канону. До 13 августа 2026 процесс жил тремя плагинами
|
||||
(`av-dev-docs`, `av-dev-tasks`, `av-dev-code`); раскол делался под раздельную
|
||||
установку, она не понадобилась ни разу, и плагины слились — тема 52
|
||||
установку, она не понадобилась ни разу, и плагины слились — тема 64
|
||||
[DECISIONS.md](DECISIONS.md).
|
||||
|
||||
Имя **скилла** несёт префикс прежнего плагина: `doc-`, `task-`, `code-`. Вызов
|
||||
@@ -148,8 +148,8 @@ flowchart TB
|
||||
путь бы разрешился, но короткое имя разрешается в устаревшую проектную копию из
|
||||
`.claude/skills/` — молча и без признаков подмены.
|
||||
|
||||
**Отсутствовать может не плагин, а часть раскладки проекта**: `docs/`, каталог
|
||||
задач, `openspec/`. Тогда вызывающий называет строкой, чего теперь не делает
|
||||
**Отсутствовать может не плагин, а часть раскладки проекта**: `.av-dev.toml`,
|
||||
`docs/`, каталог задач, `openspec/`. Тогда вызывающий называет строкой, чего теперь не делает
|
||||
никто, и работу не останавливает. Правило целиком —
|
||||
[shared/absence.md](av-dev/shared/absence.md): оно нужно почти каждому скиллу, и
|
||||
ни один им не владеет. Там же, в `shared/`, живут язык проектных текстов и
|
||||
@@ -186,8 +186,8 @@ flowchart TB
|
||||
версий](av-dev/skills/doc-canon/references/changelog.md).
|
||||
|
||||
**Версия одна, и живёт она в `.av-dev.toml` в корне репозитория** — вместе с
|
||||
настройками: `[docs] migrations` и секция `[tasks]`, где лежит каталог задач и
|
||||
как названы его части. Версий было две, пока плагинов было три и проект мог
|
||||
настройками: `[docs] migrations` и секция `[tasks]`, которая говорит, где лежит
|
||||
каталог задач и как названы его части. Версий было две, пока плагинов было три и проект мог
|
||||
взять учёт работ без канона документов; теперь плагин один, и второе число
|
||||
означало бы только вопрос, по какому журналу повышать. Прежние
|
||||
`docs/.docs.json` и `<каталог задач>/.tasks.json` не читаются: увидев их,
|
||||
@@ -375,7 +375,7 @@ python3 scripts/frontmatter.py # 0 в порядке, 1 расхождени
|
||||
а не «имя не то»;
|
||||
- **цвет charter'а, не отвечающий его модели.** Цвет кодирует модель, а не роль
|
||||
прохода — раскладка живёт в
|
||||
[review/SKILL.md](av-dev/skills/code-review/SKILL.md),
|
||||
[code-review/SKILL.md](av-dev/skills/code-review/SKILL.md),
|
||||
разделе «Модель по проходу», здесь только её механизация. Держаться вниманием
|
||||
правило не может: цвет ставится один раз при заведении charter'а, а модель
|
||||
потом меняется калибровкой;
|
||||
@@ -419,9 +419,11 @@ python3 scripts/copies.py # 0 сошлось, 1 расхождение, 2 р
|
||||
|
||||
**Копия при этом делается не всегда.** Пока плагинов было три, копия была
|
||||
единственным способом: путь в дерево соседа не разрешался. Внутри одного дерева
|
||||
скилл читает дом **по ссылке**, и дословная копия остаётся там, где текст обязан
|
||||
лежать внутри самого промпта, — в уставах вычитки, где он и есть критерий
|
||||
суждения, — и в скелетах, уезжающих в репозиторий проекта.
|
||||
справочник читается **по ссылке**, и дословная копия остаётся ровно там, где
|
||||
текст обязан лежать **внутри самого промпта**: в уставе агента, где правило и
|
||||
есть критерий суждения; в `SKILL.md`, который целиком и есть промпт скилла, — за
|
||||
ссылкой скилл пошёл бы отдельным чтением, а правило нужно ему в тот момент,
|
||||
когда он решает; и в скелетах, уезжающих в репозиторий проекта.
|
||||
|
||||
**Дом ставится в `shared/` только тогда, когда владельца нет.** У адресов
|
||||
владелец есть: раскладку `docs/` держит `doc-canon`, каталог задач —
|
||||
|
||||
Reference in New Issue
Block a user