From a38a4ba137a629c1e62d11308e0e7acca9c86792 Mon Sep 17 00:00:00 2001 From: vitya Date: Sat, 29 Aug 2026 11:40:43 +0300 Subject: [PATCH] =?UTF-8?q?docs(skill):=20admin-runbooks=20v1.1.0=20?= =?UTF-8?q?=E2=80=94=20=D1=80=D0=B0=D0=BD=D0=B1=D1=83=D0=BA=D0=B8=20=D1=82?= =?UTF-8?q?=D0=BE=D0=BB=D1=8C=D0=BA=D0=BE=20=D0=B2=20mappa=20wiki=20(?= =?UTF-8?q?=D0=B8=D0=BD=D0=B4=D0=B5=D0=BA=D1=81=20wiki:3316),=20=D1=84?= =?UTF-8?q?=D0=B0=D0=B9=D0=BB=D0=BE=D0=B2=D1=8B=D0=B9=20=D0=BA=D0=B0=D0=BD?= =?UTF-8?q?=D0=B0=D0=BB=20=D0=B7=D0=B0=D0=BA=D1=80=D1=8B=D1=82=20=E2=80=94?= =?UTF-8?q?=20task:1517?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/skills/admin-runbooks/SKILL.md | 36 ++++++++++++++------------ 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/.agents/skills/admin-runbooks/SKILL.md b/.agents/skills/admin-runbooks/SKILL.md index 8ee461b..33be328 100644 --- a/.agents/skills/admin-runbooks/SKILL.md +++ b/.agents/skills/admin-runbooks/SKILL.md @@ -1,7 +1,7 @@ --- name: admin-runbooks author: ours -version: 1.0.0 +version: 1.1.0 description: > Единый контур ранбуков зоны админа (.admin): НАЙТИ нужный ранбук перед любой прод-операцией → ИСПОЛНИТЬ по нему (чек-лист + verify + откат + письмо/таска) → @@ -24,18 +24,21 @@ description: > ## 0. ИНДЕКС РАНБУКОВ (всегда первый шаг) -**Индекс:** `.admin/.wiki/concepts/runbooks-index.md` (единственный источник -«какой ранбук для чего»). **Прибит в AGENTS.md** — контур обязателен. +**Индекс:** mappa wiki-сущность [[wiki:3316]] (`concepts/runbooks-index`, .admin) — +единственный источник «какой ранбук для чего». **Прибит в AGENTS.md** — контур обязателен. +> Файловый канал `.admin/.wiki/concepts/` закрыт (2026-08-29, task:1507): файлы — стубы +> «не читать, не править», канон — mappa wiki-сущности. Перед ЛЮБОЙ прод-операцией (деплой/редеплой/рестарт/ротация/миграция/инцидент): -1. **Прочитай индекс** (`read .admin/.wiki/concepts/runbooks-index.md`) — найди - строку по проекту/операции → путь ранбука. -2. Ранбук может жить в трёх местах (индекс указывает, где): - - `.admin/.wiki/concepts/*-runbook*.md` — канон для VDS-проектов; +1. **Прочитай индекс** (`wiki_get(project=".admin", slug="concepts/runbooks-index")`, + или [[wiki:3316]]) — найди строку по проекту/операции → ранбук (wiki-сущность). +2. Ранбук может жить в двух местах (индекс указывает, где): + - mappa wiki-сущности `.admin` (`wiki_get`/`wiki_search`) — канон для VDS-проектов + ([[wiki:160]], [[wiki:1254]], [[wiki:3330]] и т.д.; полный список — в индексе); - `<репо-проекта>/.wiki/concepts/docker-deploy.md` и т.п. — репо-вики проекта - (pilorama98.ru: `apps/web/.wiki/concepts/docker-deploy.md`); - - mappa wiki (`wiki_search`) — если индекса ещё нет, искать там. + (pilorama98.ru: `apps/web/.wiki/concepts/docker-deploy.md`) — репо-вики живут файлом, + это канал самого проекта, не `.admin`. 3. **Нет ранбука → НЕ деплоить молча.** Создать (см. WRITE) до/вместе с операцией: отдельной таской или в теле операционной таски (пункт «нужен ранбук»). Это не бюрократия: отсутствие ранбука = повторное рыскание в следующий раз. @@ -120,13 +123,11 @@ description: > ## Порядок записи (мутации вики) -- **Ранбук ОБЯЗАН быть в mappa как wiki-сущность, не только файлом** (2026-08-28, инцидент - skills-catalog-deploy: записал только файл → ранбук невидим через wiki_search, оператор - вернул «в mappa нужно писать»). Двойная запись: - 1. Файл в `.admin/.wiki/concepts/` (репо .admin, git) → commit → push (push свободно); - 2. Wiki-сущность в mappa: `wiki_create(project=".admin", slug="concepts/<имя>")` - (или `wiki_update` при правках) — тело = содержимое файла. НЕ полагаться на - mappa-импорт: он может отставать/не покрывать `.admin`. +- **Ранбук живёт ТОЛЬКО в mappa как wiki-сущность** (канон стуб wiki:3328 р.10, 2026-08-29): + `wiki_create(project=".admin", slug="concepts/<имя>")` (или `wiki_update` при правках). + Файл `.admin/.wiki/concepts/<имя>.md` — стуб-указатель «не читать, не править»; + git-история стуба хранит прежний контент (`git show :`). +- Индекс ([[wiki:3316]]) — обновить строку/ссылку на новый ранбук. - Секрет-сканер: `mcp__mappa__admin_secret_scan` после записи — 0 hits. ## Место жительства этого скила @@ -138,7 +139,8 @@ description: > ## Связи -- `concepts/runbooks-index.md` — индекс ранбуков (обязательный первый шаг). +- [[wiki:3316]] (`concepts/runbooks-index`) — индекс ранбуков (обязательный первый шаг). +- [[wiki:2608]] (AGENTS .admin) — канон зоны: runbooks rule, artifact placement rule. - `writing-skills` — RED-GREEN-REFACTOR для скилов (если править сам скил). - `using-vds-ops` — диагностика контейнеров (read-only), не деплой. - `project-discipline` — семвер/пуш-правила при правке версионируемых артефактов.