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

指令與 Skills

兩者都是「把重複提示詞寫成檔案」，觸發方式不同：

自訂指令

專案指令放 .opencode/commands/，全域放 ~/.config/opencode/commands/。test.md 就對應 /test。也可寫在 opencode.json 的 command。

---
description: 跑測試並解讀失敗
agent: build
---

跑完整測試並整理失敗原因。重點看剛改過的檔案。
$ARGUMENTS

範本可用：

可指定 agent、model。設 subtask: true 會當 subagent 跑，避免污染主對話。自訂名稱若與內建相同，會蓋掉內建指令。

每個 skill 一個資料夾，裡面放 SKILL.md。OpenCode 會搜：

Front matter 一定要有 name 與 description。name 必須小寫、數字與單一連字號，且與資料夾名相同。

---
name: git-release
description: 依已合併的 PR 草擬版本號、changelog 與 gh release 指令
---

## 什麼時候用

準備打 tag、發 GitHub Release 時載入。版本規則不清楚就先問。

Agent 只先看到名稱與描述，呼叫 skill({ name: "git-release" }) 才讀全文。因此 description 要寫到「何時該用」，不要只寫「一個 git skill」。

權限在 opencode.json：

{
  "permission": {
    "skill": {
      "*": "allow",
      "internal-*": "deny",
      "experimental-*": "ask"
    }
  }
}

載入不到時檢查：檔名必須是 SKILL.md、front matter 欄位齊、名稱不重複、沒有被 deny。