раздел 02

Как пользоваться

Работа с OpenCode выглядит как диалог. Вы пишете задачу обычными словами, агент разбирается в проекте, предлагает изменения и спрашивает разрешения, прежде чем что-то менять. Дальше вы смотрите результат и просите доработать - и так по кругу.

Дать задачу

В окне OpenCode внизу есть поле ввода. Туда вы пишете, что нужно сделать, так же как написали бы коллеге:

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

Чем конкретнее задача, тем точнее результат. Не нужно знать названия файлов - агент сам их найдёт.

Что делает агент

1
Читает проект
Сам открывает нужные файлы, чтобы понять структуру и как у вас всё устроено.
2
Предлагает изменения
Показывает, какие файлы и как собирается поменять, ещё до того как трогать код.
3
Спрашивает подтверждение
Перед записью файла или запуском команды ждёт вашего согласия.
4
Применяет и показывает результат
После одобрения вносит правки и сообщает, что сделал.

Подтверждения - ваш контроль

OpenCode не меняет файлы и не выполняет команды молча. На важных шагах он спрашивает разрешение: применить правку, запустить установку пакетов, удалить файл. Это и есть ваш рычаг управления - читайте, что агент собирается сделать, и соглашайтесь только когда понятно.

Работа с git

Лучшая страховка при работе с любым агентом - git. Перед тем как давать большую задачу, зафиксируйте текущее состояние проекта:

git add -A
git commit -m "before opencode"

Тогда что бы агент ни наделал, вы всегда вернётесь к рабочей версии:

git restore .

Сам OpenCode тоже умеет работать с git - может сделать коммит за вас, если попросить. Но привычку коммитить до задачи держите за собой.

Итерации

Редко получается с первого раза. Нормальный процесс - короткими шагами:

Маленькая задача
Просите одну понятную вещь за раз, а не переписать пол-проекта.
Проверили результат
Посмотрели, запустили, увидели что не так.
Уточнили
Сказали агенту, что поправить, и повторили.

Так вы всегда понимаете, что происходит, и не теряете контроль над проектом.