Основной процесс06 / 16
Обсуждайте и проверяйте изменения требований
На этой странице
Когда обсуждение приводит к новому продуктовому решению, попросите агента оформить его как предложение по требованиям. Проверьте формулировку, при необходимости поправьте её и решите, записывать ли её в свои документы.
Начните с конкретного контекста
Наведите указатель на нужный абзац и выберите Спросить об этом (Ask about this) слева. Noea вставит ссылку в поле ввода и покажет документ рядом с чатом. Сообщение автоматически не отправляется.
Также можно ввести @ в поле сообщения, чтобы найти документы, абзацы или объяснения. Выбранный материал появится в виде метки ссылки и будет передан агенту вместе с сообщением.
Например:
В этом правиле награды не сказано, что происходит после пропущенной отметки. Объясни текущее поведение на основе реализации, затем обсудим, стоит ли разрешать восполнение пропусков.
После принятия решения запросите предложение:
Добавь к этому правилу фразу «Разрешить одно восполнение пропущенной отметки в месяц». Предложи изменение требований для моей проверки.
Решите, исправить код или изменить требование
Когда требования и реализация расходятся, сначала спросите себя, остаётся ли исходное требование в силе. Предположим, документ требует награду после семи дней подряд, а код выдаёт её на шестой день:
| Ваше решение | Следующий шаг |
|---|---|
| Требование о семи днях остаётся. | Сохраните требование. Попросите агента исправить реализацию и проверить границу. |
| После обсуждения вы выбираете шесть дней. | Измените требование, проверьте новое условие срабатывания и реализацию. |
Не переписывайте требования лишь для того, чтобы подогнать их под существующий код. Сначала проверьте, понял ли агент требование, затем — выполняет ли его код. Уточняйте недоразумения, исправляйте ошибки реализации и меняйте требование только тогда, когда сами решите изменить правило.
Для исправления сформулируйте задачу прямо:
Сохрани требование о семи днях. Исправь преждевременную выдачу награды, проверь, что на шестой день её нет, а на седьмой она есть, и не меняй требование под текущий код.
Различайте замечания и предложения
Карточка suggestion фиксирует то, что агент считает полезным добавить к требованиям. Adopt запускает в текущем чате работу по превращению замечания в предложение, которому существующая реализация уже соответствует; это не записывает его сразу в требования. Отклонить (Dismiss) фиксирует, что вы не принимаете замечание.
Предложение содержит конкретные изменения документа для вашей проверки. Когда агент отправит его, карточка появится после завершения, остановки или ошибки текущего ответа. Выберите Показать изменения (View Changes), чтобы изучить изменения.
Проверьте изменения в документе
Режим проверки сохраняет расположение содержимого документа. Добавления выделены бледно-зелёным фоном, удаления — бледно-красным фоном и зачёркиванием. При замене показывается старый и новый текст, а где уместно, выделяются изменения отдельных слов.
Используйте нижнюю панель проверки для перехода между изменениями или выберите имя файла для переключения документа. Решение применяется ко всему предложению, включая все его файлы. Принять отдельные абзацы или файлы нельзя.
Вы можете редактировать добавленный текст и новую часть замены. Исходный текст, удаления и неизменённые абзацы в этом режиме недоступны для редактирования. После правки основным действием станет Принять мои правки (Accept My Edits).
Прежде чем принять решение, проверьте не только изменившиеся слова, но и смысл новых обязательств:
- Можете ли вы своими словами объяснить добавленные условия и термины?
- Не принята ли разовая инструкция за постоянное требование?
- Не ослабил ли агент незаметно ограничение, чтобы подогнать его под существующий код?
- Сможете ли вы найти нужное предложение в следующий раз, когда захотите изменить это поведение?
Если что-то неясно, вернитесь в чат и попросите агента объяснить или пересмотреть предложение.
Выберите действие
| Действие | Документ требований | Реализация |
|---|---|---|
| Принять (Accept) | Записывает предложение целиком. | Продолжается, если нужна работа; если условие уже выполнено, новый запуск не начинается. |
| Принять мои правки (Accept My Edits) | Записывает предложение целиком с вашими правками. | Продолжается согласно исправленному предложению. |
| Реализовать сразу (Implement Directly) | Не записывает предложение. | Реализует его; доступно только для предложений, ещё требующих реализации. |
| Отклонить (Dismiss) | Не применяет предложение. | Не запускает его реализацию. |
Принимайте проверенное решение, если оно должно направлять дальнейшую разработку. Implement Directly не фиксирует этот запрос как требование.
Отклонение предложения не отменяет уже сделанных изменений кода. Например, агент мог завершить работу до того, как предложил записать существующее поведение.
Обрабатывайте пересмотренные предложения и изменённые документы
Агент может пересмотреть предложение в том же чате. Новая версия заменит ожидающую проверку, а старая карточка сохранит пометку о версии. Правки, которые вы сделали в прежней проверке, но не приняли, автоматически не переносятся.
Если текущий документ уже не совпадает с исходным текстом предложения, принятие недоступно. Используйте Ask Agent to Re-propose on Current Version, чтобы агент перечитал документ и создал применимые изменения.
После принятия
Предложение, требующее реализации, продолжает работу в текущем чате. Если она не завершилась, воспользуйтесь Продолжить реализацию (Continue Implementing) на карточке. Затем вернитесь к документу и проверьте объяснение; если оно не обновилось, запустите Explain вручную.
Чтобы режим проверки не открывался автоматически, отключите Settings → Current Project → Automation → Open review automatically и входите в него с карточки предложения. Эта настройка управляет открытием проверки, а не принятием предложения.
Продолжите со статьёй Поддерживайте объяснения в актуальном состоянии.