Упорядочивайте растущие документы требований

Если документы начинают повторяться, связанные темы расходятся по разным местам или материал нужно объединить, используйте Упорядочить Source (Organize Source). Агент предложит план организации всех документов требований, а вы после проверки результата решите, применять ли его.

Сначала сохраните текущие правки. До принятия плана документы требований останутся прежними.

Начните упорядочивание

Наведите указатель на заголовок требований на боковой панели, нажмите кнопку упорядочивания и подтвердите действие. Noea откроет чат организации с ходом работы и записью выполнения.

Предварительно можно выбрать агента, модель и уровень рассуждения для Упорядочить Source (Organize Source) в Settings → Current Project → Operations.

Во время работы на боковой панели появляется раздел Organized с деревом документов и отметками изменений. Откройте документ, чтобы просмотреть создаваемый черновик. Предпросмотр обновляется по мере работы и не подлежит редактированию.

Оцените изменения в целом

По завершении карточка организации показывает сводку, статистику изменений, сравнение числа символов и рекомендации. Прежде чем читать текст, посмотрите, какие файлы затронуты и что объединено или перемещено.

Раздел Organized показывает предложенную иерархию с отметками добавлений, удалений, переименований и перемещений. Нажмите на элемент для проверки.

Упорядоченный черновик и текущие документы отображаются отдельно, поэтому их можно сравнивать рядом.

Проверьте предлагаемые удаления

При проверке организации весь предложенный документ показывается как текст только для чтения. Материал, предлагаемый к удалению, остаётся на месте с бледно-красным фоном, зачёркиванием и объяснением.

При принятии предлагаемые удаления выполняются по умолчанию. Если требование всё ещё важно, выберите Сохранить (Keep). Для удаления целого файла можно выбрать Сохранить весь файл (Keep Entire File). Выбор сохраняется и после перезапуска приложения.

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

Сравните с текущими документами

Выберите Compare with Original, чтобы открыть текущий документ с другой стороны. Если черновик объединяет несколько файлов, выберите исходный документ для сравнения.

Особенно проверьте следующее:

• Не потерялось ли при объединении или переформулировании условие, например выдавать награду только один раз за серию?
• Не смешаны ли правила для разных ситуаций так, что область их действия стала неясной?
• Не удалены ли действующие требования? Завершение функции само по себе не повод удалять соответствующие требования.
• Понятна ли формулировка и не превратились ли разовые инструкции к задаче в постоянные требования?

Упорядочивание должно улучшать изложение, а не незаметно менять требования. Разницу между снятием ограничения и удалением функции объясняет статья Запишите важные требования.

Примите или отклоните план целиком

После проверки нажмите Принять (Accept). Если вы выбрали элементы для сохранения, кнопка покажет их число. Принятие относится ко всему плану, включая изменения текста и структуры.

Отклонить (Reject) оставляет план неприменённым. Вы можете продолжить редактировать текущие документы и вернуться к упорядочиванию позже.

Принятие плана, меняющего текст документов, автоматически обновляет описания реализации. Изменения только имён файлов или структуры папок не запускают Explain. Это автоматическое обновление не зависит от настройки «Запускать Explain автоматически после реализации». О настройке см. статью Агенты, модели и использование.

Обработайте устаревший план

Если текущие требования меняются после создания плана, он устаревает. Его принятие становится недоступным, а вместо него предлагается Упорядочить заново (Reorganize). При сохранении текущего документа во время проверки также появляется предупреждение, что план может утратить актуальность.

Чтобы дополнительно переписать черновик, отклоните план, измените текущие документы и запустите упорядочивание снова. В отличие от нового текста обычного предложения, текст в режиме проверки организации нельзя редактировать напрямую.

Одновременно проверки может ожидать только один план организации. При запуске нового приложение предупредит, что старый будет отброшен.

Затем проверьте, нужно ли обновить объяснения.