跳到主內容

Theme / 0.3.2

ThinkRail

圍繞 pi 代理的代理式 IDE

實戰範例

在專屬工作區修一個 bug:從描述到合併

最小閉環實戰:用一個真實 bug 走完「切工作區 → 描述症狀 → 結構化提問 → 修復 → diff 審查 → commit」六步。全程不碰你的主工作目錄。

適用情境

第一次想「用代理做事」而不是「玩代理」。以一個登入逾時的 bug 為例(換成你 repo 裡任何一個小 bug 都行)。

步驟

  1. 切工作區——⌘N 開 fix/login-timeout。從這一刻起,代理的所有改動都發生在這個 worktree,你的 checkout 絲毫不動。
  2. 描述症狀,不描述解法——對話裡寫「使用者回報登入偶爾逾時,log 在 X;找出根因並修」。讓代理自己讀碼、重現、診斷。
  3. 回答結構化提問——它可能問「要修根因還是先加 timeout 重試?」這種 2–4 選項的題。看不懂就 Discuss first;選項帶 preview 時直接比較再選。它問,比你事後發現它猜錯便宜。
  4. 看這一輪的 diff——Changed view 只看改動。有意見?在 diff 上釘註解(「這裡別吞例外」)送回對話,代理照改。
  5. commit——滿意後讓它 commit(訊息讓代理寫,你審)。計畫上該步驟打勾。
  6. 收尾——小修可以直接 push;要走完整 PR 流程見出 PR 工作流。

學到什麼

  • 工作區隔離不是儀式感:bug 修到一半被叫去開會,另一個工作區照常運作
  • 「代理提問 → 你決策 → diff 審查」就是 ThinkRail 說的 review the turn, not the chat log