Перейти к основному содержимому
Проектный интеллект

Редактор документов

Редактор документов — главная поверхность коллаборативного ревью. Он работает совместно с системами базы знаний: Confluence, Bitrix24 (база знаний) и Yandex Wiki. Агент предлагает новую версию документа, а вы точечно решаете, что в неё попадёт: принимаете нужные блоки, отклоняете лишнее, дописываете вручную — и только потом публикуете.

Это замена модели «протолкнул и молился»: документ больше не обновляется целиком без вашего осмысленного контроля.

Поддерживаемые системы​

СистемаЧто это
ConfluenceСтраничная база знаний. Редактор построен на той же технологии, что и Confluence: контент передаётся в формате ADF, интерфейс — на том же редакторном движке, поэтому страницы выглядят и ведут себя как в Confluence, без потери структуры и оформления.
Bitrix24 (база знаний)База знаний портала Bitrix24: разделы и страницы знаний компании.
Yandex WikiКорпоративная вики-система: разделы и страницы знаний организации.

Механика ревью одинакова независимо от системы: черновик, помеченные блоки, решение по каждому блоку, публикация и верификация. Отличаются только структура разделов и набор полей целевой системы.

Пользовательский сценарий​

  1. Предложение. Агент готовит новую версию документа (по вашей просьбе или в рамках задачи, например после /report или обновления требований).
  2. Ревью. В рабочей области открывается черновик документа. Изменения помечены:
    • добавленный текст — выделен;
    • удалённый текст — зачёркнут;
    • рядом с каждым изменением — кнопки Принять и Отклонить.
  3. Доработка. Вы можете вручную отредактировать любой фрагмент черновика прямо в редакторе.
  4. Публикация. Кнопка Publish публикует итоговую версию в выбранную систему как новую версию документа — одним атомарным действием.
  5. Верификация. Система проверяет, что документ в целевой системе действительно обновлён, и сообщает результат со ссылкой.

Новые документы​

Можно начать с чистого черновика, не связанного с существующим документом:

  • редактор открывает пустой документ с редактируемым заголовком;
  • при первом сохранении вы выбираете место размещения в целевой системе: пространство Confluence, раздел базы знаний Bitrix24 или пространство Yandex Wiki;
  • создание идёт по тому же каналу, что и обычные публикации: без скрытых промежуточных версий.

Когда использовать​

  • Обновление страниц базы знаний по итогам решений проекта.
  • Подготовка и согласование процессных документов (процессы, регламенты, инструкции).
  • Синхронизация документации с фактическим состоянием проекта, которое агент извлек из задач и переписки.

Ограничения​

  • Перенос уже опубликованного документа в другое пространство из редактора не выполняется — это административная операция.
  • Агент не публикует документ без вашего подтверждения: публикация всегда инициируется человеком.
  • Диаграммы Mermaid сохраняются как исходный код; для отображения в Confluence требуется приложение для рендеринга Mermaid (например, Mermaid diagrams viewer).

Связанные разделы​