Документация

Описание необходимых задач

Вся форма «Новая работа» — от выбора того, что создать, до этапа проверки качества и дополнительных настроек.

В разделе «Новая работа» пользователь описывает задачу в портале. Описание результата вводится один раз. Coroid проверяет запрос перед созданием элемента, после чего преобразует его в задачу, поэтапный план, отчет или автоматизацию.

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

Новая задача
Опишите желаемый результат. Coroid найдёт оптимальный способ его реализации.
Создать как
АвтоматическиЗадачаПлан
Coroid определяет тип результата, либо вы можете выбрать его самостоятельно.
Проект
web-app
Название работы
Позволить клиентам экспортировать свои счета-фактуры в формате CSV
Краткое описание

Финансовые отделы постоянно просят предоставлять счета в виде таблицы. Добавьте кнопку экспорта в списке счетов, которая сохранит текущий фильтр в формате CSV.

Готово, если: файл открывается в Excel и Numbers, суммы указаны в валюте счёта, а экспорт более 10 000 строк не приводит к превышению времени ожидания.

Прикрепить файлы
Далее: проверка. Ничего ещё не создано.Продолжить

Форма «Новая работа»: выберите, что создать, укажите проект, затем опишите результат в заголовке и кратком описании.

Создать как

Первая строка определяет, во что превратится запрос:

ВариантРезультат
АвтоматическиCoroid выбирает нужный путь на этапе квалификации.
ЗадачаОдна задача, которая завершается одним элементом pull request.
ПланПоэтапный план, который нужно утвердить перед написанием кода.
ОтчетСгенерированный отчет.
АвтоматизацияЗадача, которая выполняется по расписанию или при определенном событии.

Автоматически Этот вариант выбран по умолчанию. Coroid анализирует запрос на этапе квалификации и подбирает подходящий путь. Если вы уже знаете нужный вариант, можете выбрать его самостоятельно: Задача Если задача представляет собой небольшое изменение, которое рецензент может прочитать за один раз, План Если требуется несколько изменений в определенном порядке или если вы хотите увидеть весь подход до того, как приступить к реализации,

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

Задача, охватывающая более одного проекта, всегда превращается в план. При добавлении второго проекта доступны только Автоматически и План Эти варианты доступны.

Форма подстраивается под выбранный маршрут. В разделе «Отчеты» запрашиваются дополнительные сведения о самом отчете, а в разделах задач и планов отображается соответствующая спецификация. У автоматизации есть собственная форма: можно указать время ее запуска и действия, которые она должна выполнять. Подробнее — Автоматизации.

Рядом с формой расположены две быстрые ссылки: Импорт задач Эта функция импортирует задачи из трекера, а Задать вопрос Coroid перепоручает ту же задачу чат-ассистенту.

Проекты

Выберите проект, к которому относится задача. Для Автоматически и План вы можете добавить больше проектов когда работа охватывает зависимые проекты. Именно так выражается межпроектная работа. Одна задача выполняется в рамках одного проекта.

Опишите работу

Два поля, и каждое выполняет свою функцию.

Название работы: краткое имя. Именно его вы будете искать в списках позже.

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

Add rate limiting to the public API.
100 requests per minute per API key. Exceeding it returns 429 with a
Retry-After header. Limits are per key, not per IP.
Internal service-to-service calls are exempt — they authenticate with
service tokens, not API keys.
Do not change the existing auth middleware's public interface.

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

Для Автоматически, Задача и План вы можете перетаскивать, вставлять или прикреплять файлы под кратким описанием: скриншоты, PDF-файлы и заметки. Задачи поддерживают изображения; планы также принимают PDF-файлы и текстовые документы.

Спецификация

У задач и планов есть Спецификация раздел с двумя вариантами:

  • Из краткого описания: вариант по умолчанию. Coroid составляет спецификацию на основе вашего краткого описания (цель, пользовательские истории и критерии приемки), затем создает и проверяет работу на соответствие ей.
  • Написать свою собственную: ваша спецификация заменяет сгенерированную. Укажите цель, пользовательские истории, критерии приемки, ограничения, бизнес-ценность, область видимости и тип самостоятельно.

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

Используйте собственный вариант, если критерии приемки уже существуют, например, в требованиях к продукту. В противном случае начните с краткого описания и скорректируйте результат на вкладке «Спецификация» задачи. См. Разработка на основе спецификации.

Расширенные настройки

Необязательно. Какие поля отображаются, зависит от маршрута.

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

Использовать рабочий процесс ЖЦП

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

Включите этот режим, если работа настолько значима, что требует контрольной точки еще до составления предварительного плана. Отключите его для задач, где техническое задание уже однозначно сформулировано. Подробнее — Рабочий процесс SDLC.

Проверка перед началом работы

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

Цель

Только для планов. Чего должен достичь план помимо технического задания. В техническом задании указано, что нужно создать; в цели — зачем это нужно.

AI профиль

Какие модели будут выполнять эту работу. Подробнее — AI профили.

Проверки качества

Какой уровень верификации применяется. Использовать стандартные настройки политики наследует параметры из политики Quality Control проекта или организации. Стандартный выполняет текущие проверки. Тщательный добавляет дополнительные тщательные проверки в реальном времени на соответствие техническому заданию и может отклонить работу, которую принял бы режим «Стандартный».

Установленная политика — фиксируется при начале выполнения. Изменение политики после этого не повлияет на уже запущенную работу. Подробнее — Политики и шлюзы качества.

Приоритет

P0 на P3, по умолчанию — P2. Приоритет определяет порядок очереди, когда задач больше, чем слотов для агентов. Он не увеличивает производительность; подробнее — Производительность и слоты агентов.

Лимит токенов

Для плана Лимит токенов на одну сгенерированную задачу ограничивает объем контекста, который может использовать каждая сгенерированная задача. Для отдельной задачи Максимальный лимит токенов ограничивает саму задачу; оставьте поле пустым, чтобы не устанавливать лимит. Увеличьте лимит для работы, требующей глубокого анализа большого кода; уменьшите его, чтобы сократить расходы на рутинные задачи.

Ограничения

Только для планов. Ограничения плана, нецелевые задачи, зависимости и правила доставки. Именно здесь указываются явные нецелевые задачи, и это самое эффективное поле для предотвращения разрастания объема работ.

Начать с / Включить в пул-реквест

Указывает ветку, с которой начинается работа, и ветку, в которую попадает pull request. То же самое, что «Начать с» Отмечено по умолчанию, поэтому оба параметра подчиняются одной настройке.

main → new Coroid branch → PR into main

Coroid всегда создает рабочую ветку. Эти поля лишь меняют точку разветвления и место размещения pull request. Они не позволяют Coroid коммитить напрямую в существующую ветку, а форма проверяет наличие этих веток на удаленном репозитории перед продолжением.

Используйте их при слиянии в другую ветку, отличную от вашей ветки по умолчанию, например в develop ветку или релизную ветку.

Спринт и целевой релиз

Задачи и Автоматически запросы, превращающиеся в задачи. Разместите задачу в спринте и свяжите её с запланированным релизом с самого начала, а не назначайте его позже.

Продолжить: Квалификация

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

Этапы проверки

  1. Нормализация и очистка
  2. Фильтрация попыток инъекции
  3. Проверка текущего релиза
  4. Удаление дубликатов и группировка
  5. Проверка или воспроизведение
  6. Оценка влияния и ответственности
  7. Направление работы

Работа не существует до тех пор, пока проверка не будет пройдена.

Прошло проверкуЗадача создана

Задача добавляется в очередь; план начинает процесс планирования. С приложенными материалами, отчётом или расписанием можно подтвердить результат рецензированием и создать задачу.

ДубликатУже исправлено

Новая работа не требуется. Дубликат объединяется с уже существующим запросом.

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

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

Все заявки сохраняются в разделе «Контроль качества» → «Проверка».

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

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

Дальнейшие действия зависят от вердикта:

  • Прошло квалификацию: как только квалификация пройдена, сразу создается задача или план без вложений и рабочего процесса SDLC. В противном случае вы возвращаетесь к форме с Рецензирование и создание, а на кнопке указано, что будет создано: Создать задачу, Создать план, Сформировать отчет или Создать автоматизацию. Новая задача сразу попадает в очередь, а новый план начинает составляться.
  • Дубликат или Уже исправлено: новая работа не создается. Дубликат объединяется с уже существующим запросом, который его покрывает.
  • Уже решено: та же самая проблема или сбой уже обрабатывается в рамках другого запроса в любом проекте. Запрос привязывается к этой работе.
  • Изменения не требуются: по результатам оценки было установлено, что зафиксированное поведение соответствует ожидаемому. Работа не создаётся.
  • Отложено: относится только к запросам, поступающим без указания ответственного лица, например, из системы приёма заявок API или от систем мониторинга. Работа соответствует критериям, но должна ждать своей очереди. полномочий мощности или бюджета. Запрос, созданный здесь, никогда не будет отложен.
  • Невозможно воспроизвести, Отклонено или Требует проверки: работа не создаётся. Отредактируйте запрос, добавьте подтверждающие данные, повторите процедуру квалификации или закройте его.

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

Запросы, ожидающие решения, перечислены в разделе Factory → Рецензирование, и каждая заявка, независимо от её вердикта, имеет собственную страницу с результатами проверок, подтверждающими данными и аудиторской историей.