Контрольные точки worktree
Краткие комментарии о состоянии работы, которые агенты обновляют через CLI.
Поле Комментарий хранит краткое состояние работы в каждом worktree. Агент может обновить его через CLI, а коллега увидит результат и следующий шаг без чтения всего чата.
Основная команда
orca worktree set --worktree active --comment "reproduced auth failure; testing credential-chain fix" --jsonКогда стоит оставлять контрольную точку
- Завершена значимая часть реализации.
- Гипотеза подтверждена или опровергнута.
- Закончена проверка кода.
- Возникла блокировка: ожидание внешних данных, ошибка в зависимости или отсутствие доступа.
- Работа переходит от исследования к исправлению или от исправления к проверке.
Формат
В первой строке укажите действие: что произошло, где и каково текущее состояние или следующий шаг.
orca worktree set --worktree active --comment "added debounce to SearchBar onChange (src/components/SearchBar.tsx); ready for review
goal: reduce redundant API calls per #298" --jsonЧтение перед записью
Если комментарий может содержать написанный пользователем контекст, сначала прочитайте его, чтобы не затереть цели и ограничения:
orca worktree current --jsonСохраните актуальную информацию, удалите устаревшую и добавьте своё обновление.
Проверка результата
После записи снова выполните orca worktree current --json и убедитесь, что поле comment содержит актуальный статус. Комментарий должен помогать продолжить работу без чтения всей истории терминала: укажите подтверждённый результат, оставшийся риск и ближайший следующий шаг.
Не помещайте в контрольную точку токены, пароли, приватные URL и персональные данные. Комментарий виден другим участникам, имеющим доступ к рабочему пространству.
Связанные статьи
Для координации нескольких исполнителей используйте оркестрацию. Быстрый переход к worktree с блокировкой разобран в рецепте «Переключение между десятью worktree».
Частые вопросы
Что такое контрольная точка worktree?
Это короткий комментарий о текущем состоянии задачи, следующем шаге или возникшей проблеме.
Когда агенту нужно обновлять контрольную точку?
После заметного этапа работы, смены плана, появления блокировки или перед передачей задачи другому исполнителю.
Заменяет ли контрольная точка коммит?
Нет. Она описывает ход работы, но не сохраняет содержимое файлов и не меняет историю Git.
Что стоит написать в комментарии?
Укажите, что уже сделано, что проверено и какой конкретный шаг должен быть следующим.
Можно ли добавлять в контрольную точку секреты?
Нет. Комментарий может быть виден другим участникам и не подходит для токенов, паролей или закрытых данных.