OpenCode TUI 常用命令行選項與斜線命令─系統指令一次學會 【OpenCode 002】

本次介紹OpenCode的CLI (命令行介面) 選項與TUI (文字介面) 的斜線命令，二者都提供了OpenCode的諸多系統功能。

1 命令行選項

OpenCode命令行不加任何參數時，會啟動TUI模式，但若提供參數選項則有不同的功能，以下介紹常用的命令選項：

2 斜線命令

2.1 什麼是斜線命令（Slash Commands）？

在 OpenCode 的輸入框中，輸入 / 就會彈出命令面板。這些以斜線開頭的指令，讓你不用記憶複雜快捷鍵，也能快速執行各種操作。它是呼叫 AI 代理與自動化功能的「傳送門」。

把斜線命令想成是「快速選單」——就像你在 Discord 或 Notion 裡輸入 / 會出現功能選單一樣，OpenCode 也提供了一套完整的命令系統。

2.2 基礎命令：生存必備

這些命令是你每天打開 OpenCode 都會用到的，優先記熟。

2.2.1 會話管理（Session）

2.2.2 模型切換（Models）

2.2.3 編輯與復原

2.3 進階命令：效率翻倍

掌握基礎後，這些命令能讓你的工作流程更加流暢。

2.3.1 介面控制

2.3.2 Skills（技能系統）

Skills 是 OpenCode 的「外掛腳本」，讓 AI 掌握特定領域的能力。

常用 Skills 推薦：

2.4 實用技巧：讓斜線命令更好用

2.4.1 @ 提及檔案

在輸入框中輸入 @ 會出現工作目錄的檔案清單，輸入部分檔名即可快速篩選。

請幫我檢查 @index.jsp 裡的 SQL 注入漏洞

2.4.2 多行輸入不誤送

• 換行：Shift + Enter 或 Ctrl + J（最穩定）
• 送出：Enter
• 清除：Ctrl + C

2.4.3 命令面板

按 Ctrl + P 開啟命令面板，可以用方向鍵選擇，不用死背命令名稱。

2.4.4 自訂命令（Custom Commands）

你可以建立自己的斜線命令，把常用提示詞（prompt）封裝成一鍵呼叫。有兩種定義方式：

2.4.4.1 Markdown 檔案（推薦）

在以下目錄建立 .md 檔案，檔名即命令名稱：

---
description: 程式碼審查
agent: plan
model: anthropic/claude-sonnet-4-20250514
---

請對當前檔案進行程式碼審查，關注以下方面：
1. 潛在的效能問題
2. 安全漏洞
3. 程式碼可讀性
4. 最佳實踐遵循情況

2.4.4.2 JSON 設定

也可以在 opencode.json 中用 JSON 定義：

{
  "command": {
    "review": {
      "template": "請對當前檔案進行程式碼審查，關注以下方面：\n1. 潛在的效能問題\n2. 安全漏洞\n3. 程式碼可讀性\n4. 最佳實踐遵循情況",
      "description": "程式碼審查",
      "agent": "plan",
      "model": "anthropic/claude-sonnet-4-20250514"
    }
  }
}

2.4.5 參數傳遞

使用 $ARGUMENTS 將命令後的文字傳入提示詞：

---
description: 建立新元件
---

使用 TypeScript 建立一個名為 $ARGUMENTS 的 React 元件，包含適當的型別定義與基本結構。

執行 /component Button 時，$ARGUMENTS 會被替換為 Button。

也可以用位置參數取得個別參數（$1、$2、$3…）：

---
description: 建立檔案
---

在 $2 目錄中建立名為 $1 的檔案，內容如下：$3
```

```bash
/create-file config.json src "{ \"key\": \"value\" }"
```

• $1 → config.json
• $2 → src
• $3 → { "key": "value" }

2.4.6 Shell 命令注入

使用 !\command`` 語法將 Bash 命令輸出嵌入提示詞：

---
description: 分析測試覆蓋率
---

以下是當前測試結果：
!\`npm test\`

根據以上結果，建議如何提高測試覆蓋率。

---
description: 審查最近的變更
---

最近 Git 提交紀錄：
!\`git log --oneline -10\`

審查這些變更並提出改進建議。

命令會在專案根目錄執行，輸出直接成為提示詞的一部分。

2.4.7 檔案參照

使用 @ 在命令中參照檔案：

---
description: 審查元件
---

審查 @src/components/Button.tsx 元件。
檢查效能問題並提出改進建議。

檔案內容會自動被包含在提示詞中。

2.5 速查表：常用斜線命令一覽

3 相關鏈接

• OpenCode 官方文件（繁體中文）
• OpenCode 官方快捷鍵文件
• Obsidian + OpenCode 知識管理組合

✅ 解說文章(繁體中文)

✅ Explanation article(English)

✅ 解説記事(日本語)

4 教學影片

https://youtu.be/fkLr0diCMrk

＃＃