@rt-tools/agent-kit 0.5.2 → 0.5.3

package/README.md

@@ -325,13 +325,41 @@ gh label create agent-kit-feedback --description 'Предложение по с
 Роль вопросов владельцу не задаёт: ни она, ни конвейер до него не достучатся. Поэтому разбор
 ведёт главный агент, а роли стоят по обе стороны от него — разведка до, конвейер после.
 
-`skill-curator` приезжает и слеш-командой: она собирает сводку о задаче и список загруженных
-правил, без которых разбор выродится в пересказ.
+`skill-curator` приезжает и слеш-командой — о ней и остальных двух ниже.
 
-Вторая команда, `next-session`, закрывает заход: приводит дерево к главной ветке — переходом на
-неё, если работа шла по правилу и отчёт влит, и вливанием в текущую ветку во всех прочих
-случаях, — снимает влитые локальные ветки, называет невлитые и пишет передачу для следующего
-захода. Незакоммиченная правка её останавливает до первого действия; поставки она не касается.
+## Слеш-команды
+
+Род `commands` ложится в `.claude/commands/`, по файлу на команду. **Имя команды — это имя
+файла:** `next-session.md` зовётся `/next-session`. Больше нигде команды не объявляются —
+перечня, который пришлось бы держать в согласии с каталогом, нет вовсе. Строка `description:` во
+вступлении файла — то единственное, что агент видит до вызова и по чему решает, брать ли
+команду; `argument-hint:` говорит, что она принимает.
+
+| Команда             | Ресурс                         | Что делает                                                     |
+| ------------------- | ------------------------------ | -------------------------------------------------------------- |
+| `/next-session`     | `commands/next-session.md`     | закрывает заход: главная ветка, влитые ветки, передача         |
+| `/skill-curator`    | `commands/skill-curator.md`    | разбирает закрытую задачу и выгружает предложения файлом       |
+| `/agent-kit-digest` | `commands/agent-kit-digest.md` | сводит накопленные предложения и наблюдения в правки ресурсов  |
+
+`/next-session` приводит дерево к главной ветке — переходом на неё, если работа шла по правилу и
+отчёт влит, и вливанием в текущую ветку во всех прочих случаях, — снимает влитые локальные
+ветки, называет невлитые и пишет передачу для следующего захода. Незакоммиченная правка
+останавливает её до первого действия; поставки она не касается.
+
+`/skill-curator` — та же роль, приехавшая командой: она собирает сводку о задаче и список
+загруженных за неё правил, без которых разбор выродится в пересказ, и кладёт предложения файлом
+с адресом в заголовке.
+
+`/agent-kit-digest` зовётся **в репозитории самого пакета**, а не в дереве, где он стоит: там
+лежат ресурсы, которые предстоит править, и видно всех потребителей сразу.
+
+Разложенная команда правится как любой разложенный файл — не на месте: либо ресурс в пакете,
+либо надстройка `.claude/rt-kit/overrides/commands/<имя>.md`. Свою команду дерево заводит файлом
+рядом; файл без шапки раскладки пакет чужим считает и не перезаписывает.
+
+Слешем зовётся и то, что командой не является: скилы — правила, паттерны и скилы без закона из
+`.claude/skills/` — и конвейеры из `.claude/workflows/`. Что из всего этого разложено и откуда
+взялось, говорят `npx agent-kit list` и `npx agent-kit doctor`.
 
 ## Как этим пользуются в дереве
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/agent-kit",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Переносимый слой правил для агента: законы, хуки, проверки и агенты, раскладываемые в репозиторий одной командой",
   "author": "RT Team",
   "license": "Apache-2.0",