Ваша первая проверка

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

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

Откройте проект с кодом

Выберите Open Folder… в рабочей области или File → Open Implementation Folder… и укажите папку с кодом.

При первом открытии этой папки Noea создаёт связанный проект. Существующий проект открывается сразу; если с папкой связано несколько проектов, Noea предложит выбрать один. Другие способы описаны в статье Открывайте проекты и управляйте ими.

Подтвердите основу проверки

Нажмите Новое требование (New Intent) на боковой панели и назовите документ «Ежедневные отметки». Noea добавит расширение .noea.md и откроет документ. Напишите:

# Ежедневные отметки

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

Сохраните документ сочетанием ⌘S в macOS или Ctrl+S в Windows / Linux. Начните с того, что уже решили; пока необязательно перечислять все пограничные случаи.

Исследуйте существующую реализацию

Объяснить (Explain) проверяет материалы проекта, объяснения к которым требуют внимания. Действие Исследование (Investigation) у абзаца проверяет только этот фрагмент. Оба действия изучают реализацию и создают или обновляют объяснения; код они не меняют.

Если отметки уже существуют, нажмите Объяснить (Explain) на боковой панели. Чтобы проверить только этот абзац, наведите на него указатель и выберите Исследование (Investigation) слева.

Если правило ещё нужно реализовать, создайте чат, введите @ в поле сообщения, выберите документ требований и отправьте:

Реализуй в этом проекте награду за отметки согласно указанным требованиям. Сначала изучи существующий код, следуй структуре проекта и проверь как серию из семи дней, так и пропущенную отметку.

Также можно воспользоваться кнопкой Реализовать (Realize) на боковой панели, если она доступна; см. статью Работайте над реализацией с агентом. Пока агент работает, в чате появляются ответы, вызовы инструментов и изменения файлов.

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

Проверьте реализацию и доказательства

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

• Описание реализации (Realization): как код считает последовательные дни и выдаёт награды.
• Доказательства (Evidence): код, вывод команд или материалы тестирования, на которые ссылается объяснение.
• Требует внимания (Attention): пробелы, решения реализации, риски или предложения, требующие вашего суждения.

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

Готовое объяснение не означает, что тесты запускались повторно. Различайте код тестов, результаты прошлых запусков и проверку, выполненную сейчас; см. статью Читайте объяснения и доказательства. Если реализация не выполняет исходное требование, исправьте её, а не переписывайте правило под код.

Задайте вопрос и зафиксируйте решение

Наведите указатель на абзац и выберите Спросить об этом (Ask about this) слева. Noea вставит ссылку в поле сообщения. Добавьте вопрос и отправьте:

Как текущая реализация обрабатывает поездки через часовые пояса? Может ли отметка из двух разных мест повлиять на серию? Объясни на основе кода.

Когда разберётесь в поведении, решите, нужно ли ограничить способ подсчёта. Если да, отправьте:

Добавь в эти требования фразу «День определяется по календарной дате в текущем местоположении пользователя». Сначала предложи изменение требований, чтобы я его проверил.

Когда агент отправит предложение, нажмите Показать изменения (View Changes) и прочитайте добавленный и заменённый текст. При необходимости отредактируйте новую формулировку, затем выберите Принять мои правки (Accept My Edits). Если правки не нужны, выберите Принять (Accept).

Если предложение требует работы над реализацией, его принятие продолжит эту работу в том же чате. Если существующая реализация уже ему соответствует, запускать её заново не нужно. Затем проверьте результаты задачи объяснения или при необходимости проведите исследование вручную.

Проверьте, что вы узнали

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

1. Как реализовано это требование и какие доказательства подтверждают вывод?
2. Какое важное решение агент принял, хотя оно не было указано в требованиях?
3. Понимаю ли я это решение и согласен ли с ним? Должно ли оно стать постоянным ограничением?
4. Какое предложение я изменю в следующий раз, когда захочу изменить это поведение?

Например, вы должны суметь объяснить, как определяется день, найти подтверждающие доказательства и указать на «семь дней подряд» как условие награды. Если ответ неясен, спросите о соответствующем абзаце.

Необязательно фиксировать все правила при первом знакомстве с проектом. Добавьте следующее решение, которое стоит сохранить, когда столкнётесь с ним.

Далее прочитайте Запишите важные требования и Читайте объяснения и доказательства.