2026-08-06 14:43:10 +03:00
parent 035bededb0
commit 8b273c9a72
16 changed files with 925 additions and 469 deletions
@@ -0,0 +1,47 @@
---
name: confluence
description: Используй, когда нужно найти или написать документацию в корпоративном Confluence — поискать страницы, прочитать содержимое, создать новую страницу. Применяй при вопросах «где документация», «есть ли дока по», «помогить найти в вики», «создай страницу», а также в команде /rfc.
---
# Работа с документацией (Confluence)
Скилл покрывает поиск и создание страниц в корпоративной вики. Адрес и токен берутся
автоматически — ничего не хардкодь и не спрашивай.
## Откуда адрес и токен
- **Адрес** — из `docsUrl` в `config/company.json` (в контекст сессии его инжектит
  расширение `company-context`). Можно переопределить переменной `CONFLUENCE_URL`.
- **Токен** — `CONFLUENCE_TOKEN` (personal access token). Задаётся в
  `~/.config/pi-kit/env.sh`. Не подставляй его в команды и не логируй.
## Инструменты
Доступны как нативные инструменты pi (регистрирует `extensions/confluence-tools.ts`):
- **`confluence_search`** — поиск страниц по CQL-запросу.
  Примеры CQL:
  - `text = "деплой"` — по тексту;
  - `title = "RFC"` — по заголовку;
  - `space = TECHRUN AND type = page` — в конкретном пространстве;
  - сложное: `(text = "kubernetes" OR title = "k8s") AND space = SRE`.
- **`confluence_page_get`** — получить страницу по ID (с `expandBody` — вернуть текст).
- **`confluence_page_create`** — создать страницу в пространстве (body — HTML в Storage
  format или обычный текст; укажи `parentId` для вложенности).
## Соглашения
- **Сначала ищи, потом создавай.** Прежде чем писать новую страницу — `confluence_search`
  по теме, чтобы не дублировать существующую.
- **Храни адреса страниц** в ответах — верни URL созданной/найденной страницы пользователю.
- Если инструмент вернул ошибку «проверь токен» — попроси пользователя проверить
  `CONFLUENCE_TOKEN`, не выдавай сам токен.
- Ключи пространств (`spaceKey`) — реальные значения посмотри через `confluence_search`; если
  запросили создать страницу, а пространство неизвестно — уточни у пользователя.
## Полезное
- Для RFC/ADR часто нужен свежий поиск в пространстве архитектуры — используй
  `confluence_search` с `space =` нужного пространства. Если карта документации
  (`docs-map`) ещё с TODO — не выдумывай пространства, спроси пользователя или начни с
  поиска, чтобы определить реальные.