日常用法
接好模型之後,日常就是:給足夠上下文、必要時先規劃、再讓 agent 改程式,改錯了就還原。把 OpenCode 當成會讀 repo 的同事,而不是一次丟一句口號。
提問與引用檔案
不確定某段邏輯時,先問、先讀,再改。用 @ 做模糊搜尋,把檔案加進對話:
檔案內容會自動進入上下文。沒指檔案時,agent 仍可能自己搜,但關鍵路徑你點出來,結果會穩很多。
開頭加 ! 可以先跑一條 shell,把輸出當工具結果餵進對話:
先 Plan,再 Build
Tab 在兩個內建 primary agent 之間切換,右下角看得到目前模式:
| Agent | 預設能力 | 適合 |
|---|---|---|
| Plan | 改檔與 bash 預設要詢問/受限 | 設計做法、檢查影響、寫實作計畫 |
| Build | 完整工具 | 真的改程式、跑測試、提交前整理 |
較大的功能建議:
- 切到 Plan,用完整句子描述目標、限制與現有畫面或 API。
- 對計畫提問、補例子;圖片可拖進終端機。
- 認同後切回 Build,請它依計畫實作。
小改動(改一個 route、補測試)可以直接在 Build 說清楚,並 @ 對照既有寫法。
講得像在帶新人
「幫我做刪除筆記」太短。寫出:刪除時在資料庫標記、另做最近刪除頁、可還原或永久刪。上下文與例子比華麗提示詞有用。
還原、重做與分享
/undo 會拿掉最近一次使用者訊息、後續回覆,以及那一輪造成的檔案變更。可連按多次。/redo 則把剛還原的內容加回來。
這兩項靠 Git 管檔案變更,所以專案需要是 Git repo。還原後可以改提示詞再試一次。
/share 會產生目前對話的連結並複製到剪貼簿,方便給同事看。預設不公開;不需要時用 /unshare。
工作階段
一次對話就是一個 session。/new(或 /clear)開新的;/sessions 列出並切換舊的。長對話可用 /compact 濃縮上下文,減少爆 token。
相關資料
推薦影音
從安裝做到第一個小應用
示範安裝、選模型、讓 agent 實作、測試除錯,最後建立 repo 並 commit。可對照本頁 Plan/Build 流程。