Рабочие документы
Файлы проекта — устав, границы объёма, требования, протоколы и другие документы (форматы MD, TXT, ADF) — открываются в том же редакторе, что и страницы Confluence. Это значит, что для документов действует та же механика ревью: агент предлагает изменения блоками с отметками, вы принимаете, отклоняете или дописываете сами.
Где живут документы
Система различает два уровня:
- Документы сессии — рабочие файлы текущего диалога: черновики, которые агент готовит вместе с вами. Их видно в панели контекста и в подсказках-«пилюлях» в чате.
- Документы проекта — устойчивые файлы рабочей области проекта: то, что остаётся между сессиями и участвует в индексации базы знаний.
Готовый документ сессии можно перенести (promote) в проект — после этого он становится частью постоянной базы знаний проекта, по которой ищет агент.
Пользовательский сценарий
- Создание. Агент по вашему запросу (или по навыку, например
/initiate,/scope,/requirements) готовит документ: «Подготовь устав проекта», «Сформируй statement границ». Файл появляется в панели контекста и в чате как ссылка. - Открытие. Клик по файлу в чате или в панели контекста открывает его в редакторе.
- Ревью правок агента. Изменения, которые агент вносит в документ, помечаются так же, как в Confluence: добавить, удалить, принять, отклонить.
- Сохранение. Вы сохраняете файл в исходном формате (Markdown или ADF) либо «Сохранить как…» в другой формат или расположение — в сессию или в проект.
- Актуальность базы знаний. Сохранение проектного документа автоматически обновляет индекс базы знаний (с задержкой на несколько минут), и новые фрагменты становятся доступны поиску.
Когда использовать
- Живые документы управления: устав, scope-заявление, реестры рисков и требований, которые агент актуализирует по мере развития проекта.
- Передача результата: черновик, собранный в диалоге, превращается в оформленный файл, который можно вынести из системы.
- Работа над спецификациями: длинные документы, где агент предлагает правки точечно, а вы контролируете каждую.
Ограничения
- Открывать в редакторе можно текстовые форматы: MD, TXT и ADF. Остальные форматы (PDF, DOCX и т.п.) доступны системе для чтения и поиска, но не для совместного редактирования.
- Перенос документа в проект — осознанное действие: агент не публикует сессионные черновики в проект без вашего решения.
Связанные разделы
- Редактор документов — та же механика для страниц базы знаний.
- Библиотека знаний — как документы участвуют в поиске и синтезе.
