pi-kit/skills/confluence/SKILL.md

name, description

name	description
confluence	Используй, когда нужно найти или написать документацию в корпоративном 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 — не выдумывай пространства, спроси пользователя или начни с поиска, чтобы определить реальные.