Skip to content

建立 2026-09-15 更新 2026-09-15

日常用法

接好模型之後,日常就是:給足夠上下文、必要時先規劃、再讓 agent 改程式,改錯了就還原。把 OpenCode 當成會讀 repo 的同事,而不是一次丟一句口號。

提問與引用檔案

不確定某段邏輯時,先問、先讀,再改。用 @ 做模糊搜尋,把檔案加進對話:

@packages/functions/src/api/index.ts 的驗證是怎麼做的?

檔案內容會自動進入上下文。沒指檔案時,agent 仍可能自己搜,但關鍵路徑你點出來,結果會穩很多。

開頭加 ! 可以先跑一條 shell,把輸出當工具結果餵進對話:

! git status

先 Plan,再 Build

Tab 在兩個內建 primary agent 之間切換,右下角看得到目前模式:

Agent 預設能力 適合
Plan 改檔與 bash 預設要詢問/受限 設計做法、檢查影響、寫實作計畫
Build 完整工具 真的改程式、跑測試、提交前整理

較大的功能建議:

  1. 切到 Plan,用完整句子描述目標、限制與現有畫面或 API。
  2. 對計畫提問、補例子;圖片可拖進終端機。
  3. 認同後切回 Build,請它依計畫實作。

小改動(改一個 route、補測試)可以直接在 Build 說清楚,並 @ 對照既有寫法。

講得像在帶新人

「幫我做刪除筆記」太短。寫出:刪除時在資料庫標記、另做最近刪除頁、可還原或永久刪。上下文與例子比華麗提示詞有用。

還原、重做與分享

/undo 會拿掉最近一次使用者訊息、後續回覆,以及那一輪造成的檔案變更。可連按多次。/redo 則把剛還原的內容加回來。

這兩項靠 Git 管檔案變更,所以專案需要是 Git repo。還原後可以改提示詞再試一次。

/share 會產生目前對話的連結並複製到剪貼簿,方便給同事看。預設不公開;不需要時用 /unshare

工作階段

一次對話就是一個 session。/new(或 /clear)開新的;/sessions 列出並切換舊的。長對話可用 /compact 濃縮上下文,減少爆 token。

相關資料

推薦影音

從安裝做到第一個小應用

示範安裝、選模型、讓 agent 實作、測試除錯,最後建立 repo 並 commit。可對照本頁 Plan/Build 流程。