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

Описание необходимых требований

Все поля формы «Новая работа» — от маршрутизации до расширенных настроек плана.

Новая работа — основной способ создания задач в Coroid. Вы описываете работу один раз, а затем направляете её как задачу, поэтапный план, отчёт или регулярное расписание.

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

Маршрутизация — сначала выберите нужный результат

Маршрутизация — это ваш выбор, а не предположение Coroid. Выберите его первым; тогда форма покажет только те параметры, которые применимы к данному результату.

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

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

Рядом с формой расположены две быстрые ссылки: Импорт задач позволяет загрузить работу из трекера, а Задать вопрос 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.

Эта последняя строка выполняет важную функцию. Строки областей определяют разницу между целенаправленным изменением и размытым объёмом работ.

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

Необязательные параметры, обычно задаются до начала планирования.

Развернутые расширенные настройки: переключатель рабочего процесса SDLC, поле Цель, профиль AI, параметры проверки качества, поле Приоритет, лимит токенов, ограничения и поле ветки COROID_TECH_0.
Развернутые расширенные настройки.

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

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

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

Цель

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

AI профиль

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

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

Какая политика качества применяется. По умолчанию используется политика Quality Control организации, и установленная политика фиксируется при начале выполнения — изменение политики организации позже не повлияет на уже запущенную задачу.

Смотрите Политики и правила качества.

Приоритет

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

Лимит токенов на одну сгенерированную задачу

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

Ограничения

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

Начинать с / Вносить изменения в

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

main → new Coroid branch → PR into main

Coroid всегда создаёт рабочую ветку. Эти поля лишь меняют точку ветвления и место, куда попадает pull request — они не позволяют Coroid вносить коммиты напрямую в существующую ветку.

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

Добавить дополнительный контекст

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

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

Запуск плана

Создать и начать планирование создаёт план на основе вашего краткого описания и сразу начинает планирование.