Skip to content

階段八(選修):OpenCode 入門 ​

約 60 分鐘(OpenCode 請在課前裝好)。換一個 AI 工具:在終端機使用開源的 OpenCode,用一個小作業專案 hw-grader,從安裝一路做到自己的作業助教。

為什麼是 OpenCode:開源 Agent + 地端模型。 Antigravity 只能用它提供的雲端模型;OpenCode 是開源的 AI Agent,可以接上各家模型,也能接學校或單位自己架設的地端模型(例如國網中心的模型服務,設定方式見 reference.md)。研究資料、未發表的程式不方便送到商用雲端時,這是兼顧隱私與彈性的組合。

前面的階段都在 Antigravity 裡用 AI;這個階段也學把 AI 的工作方式寫成設定檔:

擴充一句話這個階段做的
Skill教 AI 一套做法hw-checklist:作業繳交檢查清單
Command把常打的 Prompt 存成 /指令/commit、/check
Agent一個專職角色,有自己的權限助教 ta:只能檢查,系統不讓它改檔

重點:在提示詞裡說「不要改」,只是請求;要 AI 真的不能改,得靠權限設定。

需要:

  • 階段一的模組一(Git、uv、Node.js),以及模組四(OpenCode,用 Prompt 3 安裝)。
  • 一個 OpenCode 可以使用的模型。可以先試 OpenCode Zen 標示 Free 的模型;學校或單位有自己的模型服務時,見 reference.md。
  • 本教材以 OpenCode v1(1.19.3) 為準。OpenCode 2 已經推出,但設定方式有差異,見 reference.md。

依序閱讀:

  1. tutorial.md:教材,從安裝到做出作業助教,每一步都可以照抄
  2. reference.md:延伸閱讀,做完練習想知道更多時再看(自訂模型、更多 Agent 範例、權限細節)
  3. example/hw-grader/:完成版的設定檔,做完可以對照

🎬 示範影片:OpenCode 入門實戰(YouTube) 簡報與相關檔案見 Google Drive。 影片與簡報正在依新教材改版,目前的版本有幾處和教材不同(例如 /check 交給誰執行)。內容不同時,以 tutorial.md 為準。

AI 很快,但會出錯,要自己檢查。