вычитка слияния: имена скиллов в прозе, роли вместо плагинов

Короткие имена скиллов (tasks, canon, docs, groom, healthcheck) в прозе и в
уставах агентов заменены новыми: по прежнему имени скилл не находится. Фразы
вида «плагин задач», «плагина конвейера нет» переписаны на то, чем они были на
деле, — на часть раскладки проекта либо на скилл-владелец.
This commit is contained in:
av
2026-08-13 10:35:33 +03:00
parent a00e132f29
commit 7d559e60ec
15 changed files with 34 additions and 35 deletions
+6 -7
View File
@@ -24,8 +24,7 @@ description: Привести проект к канону документов
информационный стиль, применённый к проектным текстам, таблицы англицизмов и
жаргона. Раскладка отвечает, где текст лежит, — этот файл отвечает, каким он
должен быть. Правила общие для документов канона, задач, решений ADR и
записок разведки, и дом у них общий — `shared/language.md` в репозитории
плагинов, а этот файл его копия. Вычитывают их два прохода по охвату:
записок разведки, и это их **дом**. Вычитывают их два прохода по охвату:
документы — `doc-wording`, записи каталога задач — `task-wording`.
- [references/changelog.md](references/changelog.md) — журнал версий раскладки;
закрытые журналы до слияния плагинов лежат рядом.
@@ -54,7 +53,7 @@ python3 $ds version --dir <корень> # версия кано
**Формы `openspec/config.yaml` здесь больше нет.** Каталог принадлежит конвейеру,
и форму смотрит его скрипт — скилл `av-dev:code-openspec`, команда
`openspec.py check`. Проект работает по OpenSpec, а плагина конвейера нет — форму
`openspec.py check`. Проект работает по OpenSpec, а каталога `openspec/` нет — форму
не проверяет никто, и это надо сказать строкой доклада, а не считать, что она
верна.
@@ -139,7 +138,7 @@ capability: незаполненный канон это переходное с
2. **Судей документов на каждом `check` не зови.** Ими владеет отдельный скилл —
`av-dev:doc-healthcheck`, — и там же записано, когда его звать: он дорог, и
прогон по каждому `check` не окупается. `check` отвечает на «сходится ли
форма», `healthcheck` — на «не разошлись ли утверждения».
форма», `doc-healthcheck` — на «не разошлись ли утверждения».
3. Доклад: вывод скрипта строкой исхода и **граница покрытия** — что смотрели и
чего не смотрели. Если суждение здесь нужно, скажи это строкой и предложи
`healthcheck`, а не зови агентов сам.
@@ -225,7 +224,7 @@ capability), `openspec/config.yaml`.
отказ. Пересчитай эти пункты в докладе переходного состояния — не выдавай
их за поломку и не молчи о них.
**Задачи `docs.py` не проверяет** — их ведёт другой плагин, и согласованность
**Задачи `docs.py` не проверяет** — их ведёт другой скилл, и согласованность
каталога показывает только `tasks.py check`. Позвал на шаге 5 скилл задач —
его отчёт идёт в доклад отдельной строкой, и пункт «задачи без цели» в нём
зелёным не станет: цели не сочиняются адаптацией (запрет записан у того, кто
@@ -311,8 +310,8 @@ capability), `openspec/config.yaml`.
хуже отсутствующего: по нему будут строиться находки.
- **Не удаляет то, чьё содержимое не нашло дом.** Оригинал живёт, пока не
названо поимённо, куда переехал каждый его кусок.
- **Не ведёт содержимое канона** — это скилл `docs`. Здесь только раскладка.
- **Не заводит проект с нуля** — это скилл `init`.
- **Не ведёт содержимое канона** — это скилл `doc-sync`. Здесь только раскладка.
- **Не заводит проект с нуля** — это скилл `doc-init`.
- **Не правит историю.** В старых коммитах старые пути остаются, и это нормально.
## Доклад
+2 -2
View File
@@ -6,7 +6,7 @@
[журнала](changelog.md). Литерал в шапке был третьим и отстал на первом же
повышении — версию 13 он пережил, объявляя канон двенадцатым.
Это **единственный дом определения канона**. Скиллы `init`, `canon` и `docs`
Это **единственный дом определения канона**. Скиллы `doc-init`, `doc-canon` и `doc-sync`
читают его, а не пересказывают: три описания одной раскладки разъедутся, и
работать будет то, которое прочитали последним. Меняется канон — меняется этот
файл и появляется запись в [changelog.md](changelog.md).
@@ -19,7 +19,7 @@
Рядом лежит OpenSpec, у которого структура тоже строгая.
Цена принята сознательно: плагин не переносится на чужой репозиторий как есть —
чужой репозиторий **приводится** к канону скиллом `canon`.
чужой репозиторий **приводится** к канону скиллом `doc-canon`.
Раскладка отвечает, **где** текст лежит и на какой вопрос отвечает. Каким он
должен быть **словами** — общий для всех документов канона файл
@@ -428,7 +428,7 @@ severity стоит здесь, а не выводится каждым прох
## `openspec/config.yaml`
**Образец переехал.** Файл заводит и заполняет плагин конвейера — скилл
**Образец переехал.** Файл заводит и заполняет конвейер — скилл
`av-dev:code-openspec`, — потому что по OpenSpec работает он, а не канон
документов. Проект без конвейера каталога `openspec/` не имеет вовсе, и образец
файла, которого у него нет, в скелетах канона лежал бы мёртвым грузом.