Все руководства

Управление требованиями при работе с ИИ-агентами

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

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

Для начала достаточно одного сценария. Ниже показано, как описать назначение специалиста на выезд и проверить, что реализация учитывает конфликты расписания.

От задачи к проверяемой реализации

Одно правило может затронуть несколько частей продукта. Например, запрет пересекающихся назначений влияет на проверку расписания, ответ API и сообщение диспетчеру.

  1. Задача. Опишите результат. Например, диспетчер должен назначать специалиста на выезд и узнавать, если выбранное время уже занято.
  2. Уточнение. Уточните, какие выезды занимают время и что происходит при конфликте. ИИ-аналитик может использовать действующие правила и вынести недостающие решения на обсуждение.
  3. Спецификации. Сверьте требования к расписанию, сохранению данных, экрану и ответу API. Сравните предложения с текущими редакциями и примените согласованные пункты.
  4. Реализация. Передайте агенту требования, границы изменения и правила подсистемы. Проверьте, что выбранная реализация учитывает запросы, которые поступают одновременно.
  5. Проверка. Сопоставьте код и наблюдаемое поведение с критериями приёмки. Сохраните результат ревью, результаты выполненных тестов и оставшиеся вопросы.

Если есть расхождение, определите, нужно ли изменить код или уточнить согласованное поведение. Зафиксируйте решение в соответствующей редакции.

РычагНамерение человека и согласованные решения разворачиваются в связанные спецификации и изменения кода. Проверка сопоставляет реализацию с согласованными спецификациями.
  1. Намерение

    «Назначить техника»

    Задать намерение
  2. Уточнение

    Какие визиты?Пересечения?При конфликте?

    Ответить на вопросы
  3. Спецификации

    Предложения измененийТребования · ДанныеUI · API

    Проверить и согласовать
  4. Реализация

    Связанные изменения кодаUI · APIДанные · Правила

    Кодовый агент
  5. Проверка

    Код ↔ спецификацииВыполненные тестыQA через интерфейс

    Проверить реализацию
Рычаг

Критерии приёмки на примере расписания

Формулировка «Добавить назначение специалиста» оставляет открытыми условия и результат. Опишите, что должно произойти при допустимом назначении и при конфликте.

В этом примере критерии приёмки описывают четыре ситуации.

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

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

Открытый вопрос запишите отдельно. Например, должна ли отменённая запись занимать интервал в расписании?

Пример требования и проверок

У специалиста не может быть двух пересекающихся подтверждённых выездов

При конфликте система отклоняет запрос и сохраняет расписание.

Контекст реализации
  1. Назначение и правила поведения
  2. Модель данных, API и интерфейс
  3. Затронутые части кода
Критерии проверки
  • Запрос с конфликтом отклоняется.
  • Расписание сохраняется.
  • Правило действует при одновременных запросах.

Сопоставьте результат с требованием.

Ревью кода
Тесты API, включая одновременные запросы
Проверки интерфейса
Результаты и открытые вопросы Решение команды

Уточните, где нужна правка и какие проверки осталось выполнить.

Критерии одного требования используются и при реализации, и при проверке.

Контекст для агента разработки

Исходный код показывает, как система работает сейчас. Требование объясняет, какое поведение нужно получить и почему. Для исправления ошибки это различие особенно важно.

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

Если при реализации обнаружится открытый вопрос, запишите принятое решение рядом с требованием.

Как проверить одно требование несколькими способами

Ревью исходного кода

Проследите, где проверяется занятость специалиста и что происходит при одновременных запросах. Сверьте все пути назначения.

Что сохранитьПроверенные файлы, найденные проблемы и открытые вопросы.

Автоматизированные тесты

Проверьте допустимое назначение, пересечение выездов и два одновременных запроса. Сверьте ответ API и сохранённое расписание.

Что сохранитьРезультаты запуска с версией кода и тестовой средой.

Проверка интерфейса

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

Что сохранитьШаги, наблюдаемый результат и при необходимости снимок экрана.

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

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

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

Сколько контекста передавать агенту

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

Агенту обычно достаточно материалов, относящихся к задаче. MCP для разработки в Reqode помогает открыть связанные спецификации и найти контекст по пути к исходному файлу.

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

Как поддерживать требования в актуальном состоянии

При изменении поведения обновляйте принятые решения, связанные редакции и проверки.

  1. Согласуйте результат и ограничения.
  2. Определите затронутые данные, интерфейсы, API и исходные файлы.
  3. Сверьте реализацию с требованиями и сохраните результаты выполненных проверок.
  4. Обновите спецификации и связи по согласованным решениям. При расхождении выясните, какая запись или часть кода требует правки.

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

FieldDesk REQ-1 связан с программным модулем AssignTechnicianAction и его исходным файлом.
Связь требования с юнитом и исходным файлом в FieldDesk.

Связаться с нами

Поля, отмеченные *, обязательны для заполнения.

0 / 5 000

Можно также написать на info@reqode.com