yCode

Перед первой задачей

yCode by Yasnora AI — рабочее пространство ИИ-агента для программирования с разрешённым Git-проектом. Для общего вопроса о программировании используйте Чат; для ответа по конкретному репозиторию или проверяемого изменения — Code.

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

Free позволяет объяснять и проверять код, а также составлять планы без изменений. Редактирование файлов, запуск проверок и тщательная обработка требуют соответствующего платного доступа. Текущие лимиты задач и шагов показаны в блоке доступа Code; права на репозиторий нужны отдельно.

Выберите режим задачи

Explain or review — объяснение или ревью без записи: разберите функцию, найдите причину ошибки или оцените код. Plan only — план без записи: запросите шаги реализации, затрагиваемые файлы и проверки. Оба режима не изменяют файлы и не запускают команды терминала.

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

Шаблоны заполняют описание, но не запускают задачу. Уточните шаблон под свой проект. Предпочтение обработки задаётся отдельно: Balanced, Quick и доступный на соответствующем тарифе Thorough выбирают режим обработки, а не гарантируют качество результата.

Опишите задачу так, чтобы результат можно было проверить

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

Пример исследования без записи: «Проследи расчёт суммы заказа. Объясни, почему количество 2 даёт неверный итог. Укажи файлы и предложи исправление. Файлы не изменяй».

Пример реализации: «Исправь расчёт суммы: цена 100 и количество 2 должны давать 200. Сохрани существующую логику скидок. Добавь тесты для количества 1, 2 и 0. Запусти соответствующие тесты проекта и укажи, что не удалось проверить».

Пример планирования: «Составь план кнопки экспорта CSV на странице отчётов. Укажи изменения API, интерфейса и тестов. Сохрани проверку прав и предусмотри пустой отчёт. Пока ничего не реализуй».

Запустите первую задачу

1. Выберите разрешённый репозиторий и проверьте ветку.
2. Выберите шаблон или опишите задачу и критерии проверки самостоятельно.
3. В Options выберите права задачи и предпочтение обработки с учётом задачи и тарифа.
4. Нажмите Start task один раз. Следите за статусом и действиями, не создавая повторные запуски.
5. После завершения изучите Summary, Files changed и Checks. Завершённая задача означает готовность к проверке, а не автоматическую публикацию.

Проверьте изменения и результаты тестов

Summary показывает план и записанные действия. Files changed — пути файлов и Git diff. Сопоставьте добавления и удаления с задачей; обратите внимание на посторонние изменения, удалённые проверки и случайно попавшие секреты.

Checks показывает команды, статусы и доступный вывод. Раскройте записи и изучите ошибки. Пустой список не означает, что тесты пройдены. Запросите недостающую проверку или выполните её обычным способом в проекте.

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

Apply reviewed changes — отдельное действие для завершённых задач с изменениями. Сначала выполните ревью. Далее соблюдайте обычный процесс слияния, выпуска и развёртывания проекта: завершение задачи само по себе не публикует приложение.

Если задача требует внимания

Нет репозитория: попросите администратора подключить проект и выдать права аккаунту. Покупка тарифа не предоставляет доступ к репозиторию.

Start task недоступна: проверьте вход, выбранный репозиторий, описание, остаток лимита и соответствие режима тарифу.

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

Ошибка или остановка: перед Resume task изучите действия и вывод команд. Сначала устраните проблему доступа, настроек или неясное требование. Не перезапускайте одну и ту же ошибку без изменений.

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

Используйте Stop для ненужной активной задачи. Проверьте итоговый статус перед следующим запуском.