Способы начать работу

Заявки поступают в Coroid от пользователей портала, из Slack или Telegram, из ваших собственных систем и помощников, а также от автоматизации самого Coroid. Одним из таких способов является создание задачи в разделе «Новая работа» в портале. Все они ведут к одному и тому же пути выполнения — спецификация, план, сборка, проверка, рецензирование, запрос на объединение.

Проверено, затем направлено#

Заявка из раздела «Новая работа» или импортированная заявка не создается сразу после поступления. Сначала она проходит этап квалификации. Coroid проверяет её на наличие конфиденциальных данных, сверяет с текущим релизом, ищет дубликаты, проверяет возможности её реализации и определяет, во что она должна превратиться. Ничего не создается до тех пор, пока она не пройдет проверку. Подробнее Описание необходимого.

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

В итоге она становится одним из четырех маршрутов:

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

Механизм Ask Coroid работает иначе. В режиме Assistant чат-ассистент создает tasks и планы напрямую, без участия Qualification. При использовании чата Prepare Work, то есть управляемого рабочего процесса SDLC, утвержденная спецификация передается в Qualification перед началом планирования. Смотрите Чат-ассистент.

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

Когда начинается работа#

Никто не ждет в портале запроса от системы приема заявок API или событийной автоматизации. Coroid создает задачи через несколько минут после того, как Qualification их одобрит. То, начнется ли задача самостоятельно, зависит от источника запроса:

Задача, которая не запускается самостоятельно, ждет, пока кто-то ее инициирует. В системе Qualification запрос отображается как ожидающий инициации, со ссылкой на саму задачу. Планы никогда не запускаются автоматически: они ждут утверждения, как и всегда. Расписание ожидает в режиме проверки, пока человек не определит время его запуска.

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

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

Задача или план?#

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

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

Импортированная работа#

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

Из ваших собственных систем#

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

Для работы API требуется сервисный аккаунт, который включен в тарифные планы Professional и Enterprise. Создать его можно в разделе Настройки → Сервисные аккаунты. Ключ API должен иметь следующий диапазон прав доступа: intake:write. Ключ отображается один раз при его создании, а отключение сервисного аккаунта приводит к блокировке всех его ключей.

Отправляйте каждый запрос в шлюз API с ключом в виде токена Bearer:

curl -X POST https://api.coroid.ai/api/v1/organizations/work/intake \
  -H "Authorization: Bearer ak_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Export invoices as CSV", "content": "Customers want to download their invoices as CSV from the billing page."}'

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

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

Вместе с routes и minExposure, контракт становится измеримым: инцидент должен остаться незамеченным. Без них в контракте фиксируется, что его невозможно измерить. обязательство может отказаться начинать нереализуемую задачу.

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

События в GitHub, Slack, Telegram и Jira также могут превращаться в запросы без необходимости повторного ввода данных. Автоматизация событий направляет их на этап квалификации. См. Триггеры и целевые системы.

От ваших помощников#

Помощник или агент, который вы используете, например Hermes, Codex или Claude Code, может работать с Coroid через его сервер MCP. Он может читать информацию о ваших проектах и задачах, а также создавать, запускать и завершать работу в рамках предоставленных ему прав. Задачи, созданные им, не проходят этап квалификации. См. Coroid в качестве сервера MCP.

Автоматизированный ввод данных#

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

Проверки качества также приводят к задачам на исправление. Если политика качества обнаруживает ошибки в продукте при анализе отчёта, Coroid создаёт для них задачу на устранение. Factory → Рецензирование отображает сбои тестов, за которыми не закреплена ни одна задача. Исправить преобразует один из них в задачу на исправление.

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

В этом разделе#

• Описание необходимых требований
• Задачи
• Импорт работы
• Планы
• Спринты
• Релизы