Управление изменениями

Запрос на изменение объединяет причину работы, целевую ветку и затронутые редакции спецификаций. По нему команда и агент разработки могут определить, что нужно реализовать и проверить.
PR-87 · 1 / 7
Start with the purpose of CR-1
1 из 7

Start with the purpose of CR-1

Require photographs and customer acceptance for warranty completion. CR-1 records the baseline and proposed change in Warranty Evidence.

Состав запроса на изменение

В запросе можно сохранить принятое решение и проследить путь от него до реализации.

Цель и контекст

У каждого запроса есть постоянный ключ вида CR-*. Название и описание фиксируют причину работы и ожидаемый результат.

Ветка проекта

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

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

Укажите редакции требований, сущностей данных, интерфейсов и операций API, которые относятся к изменению.

Влияние на реализацию

На вкладке Code видны затронутые подсистемы, связанные юниты и статусы соответствия.

Исходная задача и работа ИИ-аналитика

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

Открытие и закрытие

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

ОТ ЗАМЫСЛА К КОДУ

Затронутые спецификации и код

На вкладке General указаны цель и редакции, а на вкладке Code видны юниты, связанные с этими спецификациями.

Из списка можно открыть конкретную редакцию или посмотреть действующее определение в выбранной ветке.

Используйте эти связи для оценки влияния на реализацию.

CR-1 в FieldDesk с редакциями требований и интерфейсов, веткой Warranty Evidence и задачей ISS-1.
CR-1 в FieldDesk с редакциями требований и интерфейсов, веткой Warranty Evidence и задачей ISS-1.
Другие скриншоты
Во второй редакции REQ-68 добавлена проверка завершения гарантийных работ.

Во второй редакции REQ-68 добавлена проверка завершения гарантийных работ.

В CR-1 также видны редакции сущностей данных и операций API и применённый результат ИИ-аналитика.

В CR-1 также видны редакции сущностей данных и операций API и применённый результат ИИ-аналитика.

В ISS-1 описаны недостающие подтверждения гарантийных работ и ожидаемый результат.

В ISS-1 описаны недостающие подтверждения гарантийных работ и ожидаемый результат.

Подготовка и реализация изменения

Границы работы уточняются по мере согласования требований.

1
ЗАФИКСИРУЙТЕ

Цель изменения

Опишите, почему меняется поведение, чего ожидает команда и какие ограничения нужно соблюдать.

2
ИЗОЛИРУЙТЕ

Выбор ветки

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

3
ОПРЕДЕЛИТЕ ГРАНИЦЫ

Связь с затронутыми спецификациями

Свяжите задачу ИИ-аналитика с запросом на изменение. Проверьте предложения и нажмите Apply, чтобы сохранить согласованные правки. Reqode добавит новые редакции в раздел Affected Specs.

4
ОЦЕНИТЕ

Оценка влияния на код

По связям со спецификациями проверьте, в каких подсистемах и юнитах понадобится изменить реализацию.

5
ПЕРЕДАЙТЕ В РАБОТУ

Передача агенту разработки

Укажите агенту ключ вида CR-*. Через MCP он получит затронутые артефакты и контекст реализации в нужной ветке.

6
ПРОВЕРЬТЕ

Проверка и закрытие

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

Примеры запросов на изменение

Уточнения зависят от задачи. Для корпоративного входа важны правила идентификации, для расчёта налога — порядок операций, а при выделении сервиса — границы ответственности.

Корпоративный единый вход

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

Исправление расчёта налога

  1. Обратитесь к ИИ-аналитику.
    «Рассчитывать налог после применения скидок».
  2. Разберите вопросы.
    Приведите примеры сумм и уточните, как учитывать виды скидок, округление и возвраты.
  3. Проверьте diff.
    Проверьте формулу и её влияние на данные и контракт API.
  4. Подтвердите и примените.
    Добавьте согласованные редакции расчёта в запрос.

Согласование покупки

  1. Обратитесь к ИИ-аналитику.
    «Покупки дороже 5 000 $ требуют согласования руководителя».
  2. Разберите вопросы.
    Укажите, кто согласует покупки, что происходит после отказа и кто заменяет отсутствующего руководителя.
  3. Проверьте diff.
    Проверьте, что статусы, экраны и ответы API совпадают для одного и того же сценария.
  4. Подтвердите и примените.
    Примените согласованные редакции процесса.

Выделение биллинга в сервис

  1. Обратитесь к ИИ-аналитику.
    «Вынесите биллинг в отдельный сервис, сохранив существующее поведение для клиентов».
  2. Разберите вопросы.
    Уточните, какой сервис владеет данными, какие зависимости сохранятся и как будет проходить перенос.
  3. Проверьте diff.
    Сверьте контракты API и требования к поведению, которое должно сохраниться.
  4. Подтвердите и примените.
    Сохраните согласованные спецификации биллинга в запросе.
ПЕРЕДАЧА АГЕНТУ РАЗРАБОТКИ

Работа агента по ключу запроса

MCP возвращает затронутые редакции в контексте ветки и ссылки на файлы, юниты и архитектурные правила.

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

Use Reqode MCP as the source of truth.
Start from CR-184.

Частые вопросы

Чем запрос на изменение отличается от задачи?

Задача описывает проблему или идею. Один или несколько связанных запросов фиксируют согласованные варианты изменения.

Каждому изменению нужен запрос на изменение?

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

Как правки ИИ-аналитика попадают в запрос на изменение?

Когда вы применяете предложения из связанной задачи ИИ-аналитика, Reqode добавляет редакции спецификаций в раздел Affected Specs. В списке видно, какие редакции относятся к этому изменению.

Что происходит при закрытии запроса на изменение?

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

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

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

0 / 5 000

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