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

Рабочие документы

Файлы проекта — устав, границы объёма, требования, протоколы и другие документы (форматы MD, TXT, ADF) — открываются в том же редакторе, что и страницы Confluence. Это значит, что для документов действует та же механика ревью: агент предлагает изменения блоками с отметками, вы принимаете, отклоняете или дописываете сами.

Где живут документы

Система различает два уровня:

  • Документы сессии — рабочие файлы текущего диалога: черновики, которые агент готовит вместе с вами. Их видно в панели контекста и в подсказках-«пилюлях» в чате.
  • Документы проекта — устойчивые файлы рабочей области проекта: то, что остаётся между сессиями и участвует в индексации базы знаний.

Готовый документ сессии можно перенести (promote) в проект — после этого он становится частью постоянной базы знаний проекта, по которой ищет агент.

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

  1. Создание. Агент по вашему запросу (или по навыку, например /initiate, /scope, /requirements) готовит документ: «Подготовь устав проекта», «Сформируй statement границ». Файл появляется в панели контекста и в чате как ссылка.
  2. Открытие. Клик по файлу в чате или в панели контекста открывает его в редакторе.
  3. Ревью правок агента. Изменения, которые агент вносит в документ, помечаются так же, как в Confluence: добавить, удалить, принять, отклонить.
  4. Сохранение. Вы сохраняете файл в исходном формате (Markdown или ADF) либо «Сохранить как…» в другой формат или расположение — в сессию или в проект.
  5. Актуальность базы знаний. Сохранение проектного документа автоматически обновляет индекс базы знаний (с задержкой на несколько минут), и новые фрагменты становятся доступны поиску.

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

  • Живые документы управления: устав, scope-заявление, реестры рисков и требований, которые агент актуализирует по мере развития проекта.
  • Передача результата: черновик, собранный в диалоге, превращается в оформленный файл, который можно вынести из системы.
  • Работа над спецификациями: длинные документы, где агент предлагает правки точечно, а вы контролируете каждую.

Ограничения

  • Открывать в редакторе можно текстовые форматы: MD, TXT и ADF. Остальные форматы (PDF, DOCX и т.п.) доступны системе для чтения и поиска, но не для совместного редактирования.
  • Перенос документа в проект — осознанное действие: агент не публикует сессионные черновики в проект без вашего решения.

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