Worktree kontrol noktaları

Her Nethür çalışma alanı, arayüzde görünen hafif, serbest metinli bir yorum alanı taşır — çalışma alanının o anda ne yaptığının durum anlık görüntüsü. Ajanlar bunu CLI'den güncelleyebilir ve sohbeti zorunlu kılmadan insan işbirlikçileri döngüde tutmak için önerdiğimiz kalıp budur.

Kalıp

shell
nethur worktree set --worktree active --comment "reproduced auth failure; testing credential-chain fix" --json

Kart durumu (isteğe bağlı)

Serbest metinli yorumun yanında, aşama değiştiğinde çalışma alanı kart durumunu ayarlayın:

bash
nethur worktree set --worktree active \
  --comment "fix implemented; running integration tests" \
  --workspace-status in-progress \
  --json

Durumlar: todo, in-progress, in-review, completed (veya çalışma alanınızın kullandığı özel bir kimlik).

İyi kontrol noktası anları

  • Anlamlı bir uygulama dilimi tamamlandığında.
  • Bir hipotez doğrulandığında veya çürütüldüğünde.
  • Bir kod incelemesi tamamlandığında.
  • Bir engelleyiciye takıldığınızda (harici girdi, üst kaynak hatası, eksik erişim bekleniyor).
  • İncelemeden düzeltmeye veya düzeltmeden doğrulamaya geçerken.

Biçim

İlk satır eylemdir: ne oldu, nerede ve durum ya da sonraki adım.

shell
nethur 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

Yazmadan önce okuma

Yorumda kullanıcı tarafından yazılmış bağlam olabilir; hedefleri veya kısıtları ezmemek için önce okuyun:

shell
nethur worktree current --json

Hâlâ geçerli olanı koruyun, bayat olanı çıkarın ve güncellemenizi dokuyun.