階段八(選修):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。
依序閱讀:
- tutorial.md:教材,從安裝到做出作業助教,每一步都可以照抄
- reference.md:延伸閱讀,做完練習想知道更多時再看(自訂模型、更多 Agent 範例、權限細節)
- example/hw-grader/:完成版的設定檔,做完可以對照
🎬 示範影片:OpenCode 入門實戰(YouTube) 簡報與相關檔案見 Google Drive。 影片與簡報正在依新教材改版,目前的版本有幾處和教材不同(例如
/check交給誰執行)。內容不同時,以 tutorial.md 為準。