docs(skill): admin-runbooks v1.1.0 — ранбуки только в mappa wiki (индекс wiki:3316), файловый канал закрыт — task:1517
This commit is contained in:
@@ -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 <parent>:<path>`).
|
||||
- Индекс ([[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` — семвер/пуш-правила при правке версионируемых артефактов.
|
||||
|
||||
Reference in New Issue
Block a user