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

Coroid: документация

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

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

В этих документах описан продукт в текущей версии. Если какая-то функция здесь не упомянута, значит она пока недоступна.

Новичкам

Пройдите по шагам Начать работу по порядку. Этот процесс проведет вас от пустого аккаунта до объединенного pull request: создайте организацию, подключите репозиторий, сформируйте проект, запустите задачу, проверьте результат.

Узнайте, как это работает

Как задача превращается в pull request — это страница, на которую ссылаются все остальные материалы: полный путь от вашего описания до создания PR, со всеми этапами, названными поименно.

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

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

    Что будет создано и как вы узнаете, что это сработало

    АрхитекторВы можете изменить
  2. 2План

    Упорядоченные шаги, согласованные перед написанием кода

    АрхитекторВы утверждаете
  3. 3Сборка

    Код и тесты, написанные в изолированном рабочем пространстве

    Разработчик
  4. 4Проверка

    Ваш набор тестов, а также проверки и критерии качества

    Специалист по тестированию
  5. 5Рецензирование

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

    Рецензент
  6. 6Запрос на объединение

    На ветке вашего репозитория, ожидает вашего решения

    Вы сливаете

Неудачные результаты проверки и исправляемые замечания рецензента возвращаются разработчику для доработки, прежде чем откроется pull request.

Шесть этапов, каждый со своим ответственным. Вы вмешиваетесь на этапах спецификации, планирования и слияния.

Ориентироваться в интерфейсе

РазделЧто охватывается
Начать работуОт аккаунта до первого объединенного pull request
Основные понятияКак устроена система на практике
Работа и планированиеЗапуск работы, задачи, планы, релизы
Проекты и кодРепозитории, настройка сборки и тестирования, контекст
ЗаводВыполнение работы, автоматизации, отчеты
Качество и проверкаЭтапы проверки, обнаруженные проблемы, подтверждения, браузерные тесты
ГлобализацияЯзыки, переводы, код, готовый к использованию во всем мире
Операции и мониторингMission Control, обнаруженные проблемы, уведомления
Настройки организацииУчастники, ключи, политика, хранение данных
Выставление счетов и емкостьСлоты, кредиты, использование, счета-фактуры
ИнтеграцииУправление исходным кодом, чат, MCP, подтверждения, хуки
СправочникГлоссарий, статусы, ограничения, решение проблем

Три важных момента, которые стоит знать сразу

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

NEEDS_HUMAN_REVIEW — это не сбой. Это означает, что работа достигла этапа, требующего вашего решения. Ответьте на запрос, и задача продолжится. Подробнее Статусы задач.

Что-то работает не так, как ожидалось

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