Skip to content

opencode

Jump to bottom
Each Chen edited this page Jun 25, 2026 · 1 revision

opencode 使用教學

把整個 repo 放在本機，讓 opencode 在這個資料夾中啟動，並明確要求它依照 SKILL.md 和 references/ 回答。

Clone

git clone https://github.com/iach526526/nchu-dorm-rules.git
cd nchu-dorm-rules

驗證資料（可選）

python3 scripts/validate_skill.py

如果缺套件：

python3 -m pip install pyyaml

在 repo 裡啟動 opencode

opencode

然後貼上：

請使用這個 repo 的 SKILL.md 作為回答規則，並從 references/ 裡查中興宿舍法規。回答時請給明確結論、相關規定、違規後果，並附官方 PDF 來源。問題：中興大學女生宿舍可以帶非住宿生進入嗎？如果不行，做了會怎樣？

建議固定提示

如果你的 opencode 版本支援自訂 agent、project instructions、rules 或 prompt preset，可以把下面這段存進去：

這個專案是 nchu-dorm-rules，一個中興大學宿舍法規查詢 skill。回答宿舍問題時，請先讀 SKILL.md，依照 Retrieval Workflow 查 references/index.md、references/faq_map.md、references/rules_structured/ 和 references/rules/。不得臆測規定；文件沒有明確答案時請說明不清楚。回答必須包含明確結論、依據條文、違規後果，並附官方 PDF 來源 URL。

快速單次問答

如果你的 opencode 支援直接帶 prompt 執行，可以用類似這種方式：

opencode "請根據 SKILL.md 和 references/ 回答：中興大學女生宿舍可以帶非住宿生進入嗎？如果不行，做了會怎樣？"

若你的版本不支援這種直接參數，就用互動模式貼上同一段文字。

更新資料

git pull
python3 scripts/validate_skill.py

成功判斷

成功時，opencode 的回答應該會：

  • 明確說可不可以。
  • 提到它依據女宿或相關宿舍法規。
  • 說明違規後果。
  • 附官方 PDF URL。

如果它只回答「建議詢問宿舍管理員」但沒有引用文件，代表它可能沒有讀到 SKILL.md 或 references/。請確認你是在 nchu-dorm-rules 目錄裡啟動 opencode。

常見問題

我可以把它裝成 opencode 的 agent 嗎

如果你的 opencode 版本支援自訂 agent，可以。請把 SKILL.md 的內容當作 agent 指令，並把 references/ 保留在 agent 可以讀到的位置。

可以只上傳 PDF 嗎

不建議。PDF 只有法規本身，SKILL.md 和 references/index.md 才會告訴 agent 怎麼挑文件、怎麼引用、遇到衝突怎麼處理。

問題要怎麼寫比較準

請寫清楚宿舍類型，例如：

女宿晚歸會怎樣？

男宿可以帶非住宿生進去嗎？

興大二村可以養寵物嗎？

Clone this wiki locally