coding-agent

• 建構或創建新功能與應用程式 — 讓 coding-agent 探索程式碼庫並進行端對端實作，而非僅在行內進行修補。
• 審查 Pull Request — 在臨時複製的儲存庫或 git worktree 中啟動代理程式，使其能安全地比對差異、分析並摘要變更內容。
• 重構大型程式碼庫 — 需要跨多個檔案存取上下文的多檔案變更，特別適合使用能夠遍歷專案目錄樹的代理程式。
• 並行修復問題 — 使用 git worktrees 同時執行多個代理程式，每個問題對應一個代理程式，再從各分支建立 PR。

• 簡單的單行修復 — 如果變更明顯且範圍局限，直接編輯檔案即可；啟動 agent 會增加不必要的開銷。
• 唯讀程式碼探索 — 使用讀取/grep 工具來檢查程式碼，而非啟動完整的 coding-agent。
• 在 ~/clawd 或即時 OpenClaw 工作區內作業 — 絕對不能在協調器自身的工作目錄中啟動 agent。
• 執行緒綁定的 ACP harness 請求 — 如果需要在 Discord 執行緒或類似的 ACP 情境中啟動或執行 Codex/Claude Code，請改用 sessions_spawn 搭配 runtime:"acp"。

支援四種不同的 coding-agent，並為每種提供正確的呼叫模式。Codex 和 Pi 需要 pty:true 以實現互動式終端行為；Claude Code 則使用 --print --permission-mode bypassPermissions 以進行乾淨的非 PTY 執行。

長時間執行的任務可透過 background:true 啟動，這會回傳一個 sessionId。接著您可以使用 process 工具動作來輪詢狀態、串流日誌、傳送標準輸入，或終止工作階段——在不阻塞操作的情況下持續向使用者回報進度。

設定 workdir 可確保代理在正確的專案資料夾中啟動，不會誤入無關的檔案。這對於 PR 審查和並行問題修復至關重要。

為每個問題建立獨立的 git worktree，在每個 worktree 中啟動專屬的代理程式，同時監控所有進度，並推送獨立的分支以建立 PR——全程不會影響主分支。

在代理程式的提示詞末尾附加一個 openclaw system event 指令，讓協調器在任務完成時立即收到喚醒事件，而無需等待下一次心跳輪詢。

審查作業一律在臨時複製的儲存庫或 git worktree 中執行，絕不在正式專案資料夾內進行，以防止意外切換分支或對現有程式碼庫造成任何變動。

將 Codex 或 Claude Code 的 coding-agent 指向您的專案目錄，透過 workdir 參數搭配明確的功能需求提示詞。代理程式會自動探索程式碼庫、跨多個檔案實作該功能並提交變更——同時您可透過 process action:log 監控執行過程。

擷取所有開放中的 PR 參照，以背景模式為每個 PR 啟動一個 Codex 程序，收集各自的審查結果，並透過 gh CLI 將結果以 GitHub 留言形式發布——全程平行執行。

為每個開放的問題建立一個 git worktree，在每個 worktree 中啟動一個 coding-agent，監控進度，然後推送分支並開啟 PR 供人工審查——大幅縮短修復時間。

對於沒有現有專案的快速單次提示，可建立一個暫時目錄，執行 git init，讓 coding-agent 完成一個自成一體的任務，完成後再刪除該目錄。