斜線指令 (Slash Commands)

概覽 (Overview)

斜線指令 (Slash Commands) 是在互動式工作階段 (Interactive Session) 中控制 Claude 行為的快捷方式。它們主要分為幾種類型：

內建指令 (Built-in Commands)：由 Claude Code 提供 (/help, /clear, /model)
技能 (Skills)：使用者定義的指令，建立為 SKILL.md 檔案 (/optimize, /pr)
外掛程式指令 (Plugin Commands)：來自已安裝外掛程式的指令 (/frontend-design:frontend-design)
MCP 提示詞 (MCP Prompts)：來自 MCP 伺服器的指令 (/mcp__github__list_prs)

注意：自訂斜線指令已併入技能 (Skills) 中。位於 .claude/commands/ 中的檔案仍可正常運作，但現在建議使用技能 (.claude/skills/)。兩者皆能建立 /command-name 快捷方式。完整參考請參閱技能指南 (Skills Guide)。

內建指令參考 (Built-in Commands Reference)

內建指令是常用動作的快捷方式。目前有 60 個以上的內建指令與 10 個隨附技能 (Bundled Skills) 可供使用。在 Claude Code 中輸入 / 即可查看完整清單，或輸入 / 後跟隨任何字母進行過濾。

注意：自 v2.1.236 起，若在打錯字或於當前工作階段中不可用的斜線指令上按下 Enter，系統會回報錯誤，而不再默默執行最接近的模糊比對 (Fuzzy Match)。明確的前綴與已定義的別名 (Aliases) 仍會像以前一樣正常執行。

指令 (Command)	用途 (Purpose)
`/add-dir <path>`	新增工作目錄 (Working Directory)
`/advisor [model\|off]`	設定顧問 (Advisor)。在互動式對話方塊中開啟；在桌面應用程式、遠端控制 (Remote Control) 和無頭 (Headless) (`-p` / Agent SDK) 工作階段中，則採用文字形式 — 單純的 `/advisor`、`/advisor <model>` 或 `/advisor off` (v2.1.260+)
`/agents`	管理代理設定 (Agent Configurations)
`/branch [name]`	切換至此時間點的對話副本，同時保留原始對話 (使用 `/resume` 可返回)
`/fork [prompt]`	將當前對話複製至新的背景工作階段 (Background Session) 並在此處繼續工作；從該點起兩者彼此獨立，副本會在 `claude agents` 中獲得專屬的整行紀錄 (v2.1.212+)。除非副本在原地進行編輯，否則 Claude Code 會指示它在進行程式碼變更前建立自己的工作區 (Worktree) (隔離指示需要 v2.1.221+)
`/subtask <task>`	產生一個分叉子代理 (Forked Subagent)，繼承完整對話並處理任務，而您可繼續進行操作；其結果會在完成時返回至此對話 (v2.1.212+)
`/btw <question>`	在 Claude 處理主要任務時提出短暫的旁支問題；不會污染主對話脈絡 (Main Conversation Context)
`/cd <path>`	將工作階段移動至新的工作目錄，且不會破壞提示詞快取 (Prompt Cache) (v2.1.169 新增)
`/chrome`	設定 Chrome 瀏覽器整合 (Chrome Browser Integration)
`/clear`	清除對話 (別名：`/reset`, `/new`)
`/color [color\|default]`	設定提示詞列顏色。單純輸入 `/color` (無引數) 可隨機選擇工作階段顏色 (v2.1.128+)；傳入顏色名稱或 Hex 值可進行明確設定。
`/compact [instructions]`	壓縮對話 (Compact Conversation)，可選擇附帶焦點指示。壓縮失敗時會在 UI 中顯示為錯誤，而非默默地毫無動作 (v2.1.216)
`/config`	開啟設定 (Settings) (別名：`/settings`)
`/context`	以彩色網格視覺化顯示脈絡使用量 (Context Usage)。當使用量超過脈絡視窗限制 (Context Window Limit) 時顯示明確警告 (v2.1.216)
`/copy [N]`	將助理回應複製至剪貼簿；`w` 可寫入檔案
`/cost`	`/usage` 的輸入快捷別名 — 開啟成本分頁 (v2.1.118+)
`/desktop`	在桌面應用程式中繼續 (別名：`/app`)
`/diff`	用於未修訂變更 (Uncommitted Changes) 的互動式 Diff 檢視器。在全螢幕轉譯中，它會在對話旁開啟一個 Diff 面板並保持開啟，讓您能邊工作邊查看 — 面板會列出變更的檔案以及新增/移除的行數，並在 Claude 每次編輯檔案或執行 Shell 指令時自動重新整理；再次執行 `/diff` 或點擊 `✕` 可將其關閉 (v2.1.260+)。傳統轉譯器則會在提示詞位置開啟檢視器
`/doctor`	診斷安裝健康狀況 — 可在 Claude 回應時開啟；顯示狀態圖示；按下 `f` 可自動修復問題 (在 v2.1.116 中增強；在 v2.1.178 中將版面配置更新為具有更清晰圖示的扁平樹狀圖)
`/effort [low\|medium\|high\|xhigh\|max\|auto]`	透過互動式方向鍵滑桿設定努力程度 (Effort Level)。等級：`low` → `medium` → `high` → `xhigh` (v2.1.111 新增) → `max`。在 Opus 5、Sonnet 5 和 Opus 4.8 上預設為 `high` (在 Opus 4.7 上為 `xhigh`)；`xhigh` 需要 Opus 5、Sonnet 5、Opus 4.8 或 Opus 4.7；`max` 可在 Opus 5、Sonnet 5、Opus 4.8/4.7/4.6 及 Sonnet 4.6 上運作。選單還提供 `ultracode` (非模型努力程度 — 會發送 `xhigh` 並讓 Claude 協調動態工作流程 (Dynamic Workflows)；僅限當前工作階段)
`/exit`	離開 REPL (別名：`/quit`)
`/export [filename]`	將當前對話匯出至檔案或剪貼簿
`/usage-credits`	設定速率限制 (Rate Limits) 的額外使用量 (在 v2.1.144 中從 `/extra-usage` 更名；`/extra-usage` 仍可作為別名使用)
`/fast [on\|off]`	切換快速模式 (Fast Mode)。適用於 Opus 5 和 Opus 4.8 (v2.1.219)
`/feedback`	提交回饋 (別名：`/bug`)。自 v2.1.141 起，可附帶近期工作階段 (過去 24 小時或 7 天)，使跨越金多個工作階段的回報能包含脈絡。自 v2.1.178 起，`/bug` 必須提供描述才能提交。
`/focus`	切換焦點檢視 (Focus View) (v2.1.110 新增；取代用於焦點切換的 `Ctrl+O`)
`/goal <statement>`	註冊工作階段層級的完成條件 (Completion Condition)；Claude 會持續工作直到目標達成。使用 `/goal clear` 可將其移除。作用中的目標會顯示在狀態列中，並附有即時覆蓋面板顯示已用時間、輪次計數和 Token 使用量 (v2.1.139 新增)。
`/help`	顯示說明
`/hooks`	檢視 Hook 設定 (Hook Configurations)
`/ide`	管理 IDE 整合
`/init`	初始化 `CLAUDE.md`。設定 `CLAUDE_CODE_NEW_INIT=1` 以使用互動式流程
`/insights`	產生工作階段分析報告 (Session Analysis Report)
`/install-github-app`	設定 GitHub Actions 應用程式
`/install-slack-app`	安裝 Slack 應用程式
`/keybindings`	開啟按鍵繫結設定 (Keybindings Configuration)
`/fewer-permission-prompts`	分析近期的 Bash/MCP 工具呼叫，並將優先允許清單 (Allowlist) 新增至 `.claude/settings.json` 以減少權限提示 (v2.1.111 新增)
`/login`	切換 Anthropic 帳號
`/logout`	登出您的 Anthropic 帳號
`/mcp`	管理 MCP 伺服器與 OAuth
`/memory`	編輯 `CLAUDE.md`，切換自動記憶 (Auto-memory)
`/mobile`	顯示行動應用程式的 QR code (別名：`/ios`, `/android`)
`/model [model]`	使用左右方向鍵選擇模型並調整努力程度。自 v2.1.153 起，選擇會儲存為新工作階段的預設值 (與 IDE 相符)；選擇後按下 `s` 則僅套用於當前工作階段。(按鍵繫結 `modelPicker:setAsDefault` 已更名為 `modelPicker:thisSessionOnly`；舊有的 `d` 動作現在改為 `s`。) 自 v2.1.219 起，選擇器將合併後的 Opus 行顯示為 "Opus (1M context)"。
`/passes`	分享 Claude Code 免費一週試用
`/permissions`	檢視/更新權限 (別名：`/allowed-tools`)
`/plan [description]`	進入計畫模式 (Plan Mode)
`/plugin`	管理外掛程式 (Plugins)
`/proactive`	`/loop` 的別名 (v2.1.105 新增)
`/powerup`	透過附帶動畫展示的互動式課程探索功能
`/privacy-settings`	隱私權設定 (僅限 Pro/Max)
`/release-notes`	檢視版本變更日誌 (Changelog)
`/recap`	在返回工作階段時顯示工作階段回顧 / 摘要 (v2.1.108 新增)
`/reload-plugins`	重新載入作用中的外掛程式。自 v2.1.221 起，大多數安裝會立即啟用，因此只有在安裝摘要顯示 `Run /reload-plugins to activate.` 時才需要執行。自 v2.1.260 起可在無頭工作階段中使用，因此它也會出現在 Claude Code Desktop 和 SDK 的指令清單中
`/reload-skills`	重新掃描技能目錄，無需重啟工作階段 (v2.1.152 新增)
`/remote-control`	來自 claude.ai 的遠端控制 (別名：`/rc`)
`/remote-env`	設定預設遠端環境 (Default Remote Environment)
`/rename [name]`	重新命名工作階段
`/resume [session]`	恢復對話 (別名：`/continue`)
`/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]`	`/code-review` 的別名 (v2.1.223)：審查當前的 Diff，或您傳入的 PR 編號、分支或路徑 — 例如 `/review 1234`。接受相同的努力程度與旗標。若未給予努力程度，它會重用您上次輸入的 `low`–`max` 等級
`/rewind`	倒回對話及/或程式碼 (別名：`/checkpoint`)
`/sandbox`	切換沙盒模式 (Sandbox Mode)
`/schedule [description]`	建立/管理雲端定時任務 (Cloud Scheduled Tasks)
`/scroll-speed <+N\|-N>`	透過即時預覽微調 TUI 即時預覽面板的滑鼠滾輪捲動速度。以每台機器為單位持久化儲存至 `~/.claude/preferences.json` (v2.1.139 新增)。
`/security-review`	分析分支中的安全性漏洞 (Security Vulnerabilities)
`/skill-doctor`	顯示有哪些已載入的技能未使用以及各自在脈絡中消耗的成本，以便您決定要關閉哪些。報告會在 `/plugin` 管理器的 Stats 分頁中開啟；在非互動式的 `-p` 模式中則列印為文字。在遠端控制下它會回應 `Skill usage reports are not available on this connection.` — 請在託管工作階段的機器終端機中執行它 (需要 v2.1.252+)
`/skills`	列出可用技能
`/stats`	`/usage` 的輸入快捷別名 — 開啟統計資料分頁 (每日使用量、工作階段、連續記錄) (v2.1.118+)
`/stickers`	訂購 Claude Code 貼紙
`/status`	顯示版本、模型、帳號，以及讀取為 `background job · attached`、`background job · unattended` 或 `interactive` 的 `Session kind` 行 (欄位新增於 v2.1.221)。可在 Claude 回應時開啟
`/statusline`	設定狀態列
`/tasks`	列出/管理背景任務
`/team-onboarding`	根據專案的 Claude Code 設定產生團隊成員上手指南 (Team Ramp-Up Guide) (v2.1.101 新增)
`/teleport`	在此終端機中恢復網頁版 Claude Code 工作階段；開啟網頁工作階段選擇器 (別名：`/tp`)。需要 claude.ai 訂閱
`/terminal-setup`	設定終端機按鍵繫結
`/theme`	開啟主題選擇器 / 管理自訂主題 (v2.1.118)。透過 `~/.claude/themes/<name>.json` 中的 JSON 定義自訂主題
`/tui`	切換全螢幕 TUI (文字使用者介面) 模式，具備無閃爍轉譯 (v2.1.110 新增)
`/ultrareview`	全面的基於雲端的多代理程式碼審查 (Cloud-based Multi-agent Code Review) (v2.1.111 新增)。首選呼叫方式現在改為 `/code-review ultra`；`/ultrareview` 仍保留為別名。包含在 Pro 和 Max 方案上的 3 次免費執行，之後需要使用點數
`/upgrade`	開啟升級頁面以取得更高的方案層級
`/usage`	權威使用量儀表板 (v2.1.118) — 結合方案使用量限制、速率限制、成本和每日工作階段統計資料。`/cost` 和 `/stats` 是開啟特定分頁的輸入快捷別名
`/voice`	切換按鍵發話 (Push-to-talk) 語音聽寫
`/workflows`	檢視執行中與已完成的動態工作流程執行 (v2.1.154 新增)。參閱動態工作流程 (Dynamic Workflows)

為什麼 /cd 很重要：過去變更目錄會失去快取溫暖度 (Cache Warmth) (導致下一輪變慢且成本更高)；/cd 可在切換過程中保留提示詞快取。

隨附技能 (Bundled Skills)

這些技能隨 Claude Code 一起附帶，並可像斜線指令一樣被呼叫：

技能 (Skill)	用途 (Purpose)
`/batch <instruction>`	使用工作區 (Worktrees) 協調大規模的平行變更
`/claude-api`	載入專案語言的 Claude API 參考資料
`/dataviz`	圖表與儀表板設計指導，附帶可執行的調色盤驗證器 (v2.1.198)
`/debug [description]`	啟用除錯日誌記錄 (Debug Logging)
`/design [description]`	建立設計畫布 (Design Canvas) — 一個多畫板視覺化設計 (UI 模型、螢幕流程、落地頁面、海報)，發佈為產出物 (Artifact) 並以視覺化方式而非在程式碼中進行微調。當您想要疊代佈局時，可用它來代替手寫 HTML。研究預覽版；需要 v2.1.233+ 以及 Pro、Max、Team 或 Enterprise 方案
`/loop [interval] <prompt>`	按時間間隔重複執行提示詞
`/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]`	審查當前的 Diff — 或您傳入的 PR 編號、分支或路徑 — 以找出正確性缺陷 (Correctness Bugs)。傳入 `--fix` 可套用發現結果，傳入 `--comment` 可將其作為內聯 GitHub PR 留言發佈，或傳入 `ultra` 以執行深入的雲端審查；在 `github.com` PR 目標上使用 `ultra` 時，`--post` 會預先選擇將發現結果發佈至 PR。若未給予努力程度，審查會重用您上次輸入的等級 (v2.1.223)。最初在 v2.1.146 中吸收了 `/simplify`，但 `/simplify` 在 v2.1.154 中作為獨立指令回歸
`/simplify`	執行僅限清理的審查 (重用 / 簡化 / 效率 / 層級) 並套用修復；不會尋找 Bug — 尋找 Bug 請使用 `/code-review`。曾短暫作為 `/code-review --fix` 的別名 (v2.1.152)，但在 v2.1.154 中變更為僅限清理

已廢棄的指令 (Deprecated Commands)

指令 (Command)	狀態 (Status)
`/output-style`	在 v2.1.91 中移除 (在 v2.1.73 中廢棄) — 請使用 `/config` → Output style，或 `outputStyle` 設定
`/pr-comments`	在 v2.1.91 中移除 — 請直接要求 Claude 查看 PR 留言
`/vim`	在 v2.1.92 中移除 — 請使用 /config → Editor mode
`/undo`	截至 v2.1.245 已不再列於官方指令參考中 (在 v2.1.108 中作為 `/rewind` 的別名新增) — 請使用 `/rewind` 或按下 `Esc` 鍵兩次

近期變更 (Recent Changes)

/fork 與 /subtask 在 v2.1.212 中交換了角色。/fork 現在會將對話複製至新的獨立背景工作階段中；其過去擁有的分叉子代理行為已移至新的 /subtask 指令。歷史紀錄：/fork 在 v2.1.77 至 v2.1.161 期間是 /branch 的別名；從 v2.1.161 到 v2.1.211 它會啟動分叉子代理 (即現在 /subtask 的功能)。當關閉代理檢視 (Agent View) 時，/subtask 不可用，且 /fork 會保留分叉子代理行為
/resume (無引數) 會開啟過去工作階段的選擇器 — 包含已從可見清單中移除的工作階段 — 並將選擇的工作階段作為背景工作階段恢復 (v2.1.212)
/output-style 已廢棄 (v2.1.73) 並移除 (v2.1.91) — 輸出樣式仍可透過 /config → Output style 或 outputStyle 設定取得；內建樣式包含 Default、Proactive、Explanatory、Learning 和 Concise (新增於 v2.1.237)
/review 成為 /code-review 的完整別名 — 相同的目標、努力程度與旗標 (v2.1.223)。歷史紀錄：它最初在 v2.1.186 中移至 /code-review medium 引擎，但仍僅限 PR
新增 /effort 指令；max 等級可在 Opus 4.6+ 上使用 (最初僅限 Opus 4.6)
新增 /voice 指令用於按鍵發話語音聽寫
新增 /schedule 指令用於建立/管理定時任務
新增 /color 指令用於自訂提示詞列
/pr-comments 在 v2.1.91 中移除 — 請直接要求 Claude 查看 PR 留言
/vim 在 v2.1.92 中移除 — 改為使用 /config → Editor mode
/ultraplan 已在 v2.1.222 中移除 — 改為使用計畫模式 (Plan Mode)
新增 /powerup 用於互動式功能課程
新增 /sandbox 用於切換沙盒模式
/model 選擇器現在顯示易讀的標籤 (例如 "Sonnet 4.6") 而非原始的模型 ID
/resume 支援 /continue 別名
MCP 提示詞可作為 /mcp__<server>__<prompt> 指令使用 (參閱作為指令的 MCP 提示詞)
新增 /team-onboarding 用於自動產生團隊成員上手指南 (v2.1.101)
新增 /tui 指令用於無閃爍的全螢幕 TUI 轉譯 (v2.1.110)
新增 /focus 指令用於切換焦點檢視；Ctrl+O 現在僅切換詳細逐字稿 (Verbose Transcript) (v2.1.110)
新增 /recap 指令以手動觸發工作階段脈絡回顧 (v2.1.108)
新增 /undo 作為 /rewind 的別名 (v2.1.108)；截至 v2.1.245 它不再出現在官方指令參考中 — 請使用 /rewind 或 Esc Esc
新增 /proactive 作為 /loop 的別名 (v2.1.105)
/effort 獲得了互動式方向鍵滑桿以及在 high 和 max 之間的新 xhigh 等級；Opus 4.7 方案的預設努力程度提升至 xhigh (v2.1.111)。在 Opus 4.8 上預設為 high (v2.1.154)；Opus 5 也預設為 high (v2.1.219)
新增 /ultrareview 用於全面的基於雲端的多代理程式碼審查 (v2.1.111)
新增 /fewer-permission-prompts 以分析 Bash/MCP 工具呼叫，並透過 .claude/settings.json 中的允許清單減少權限提示 (v2.1.111)
自動模式 (Auto Mode) 在 Opus 4.7 上不再需要 Max 訂閱者的 --enable-auto-mode 旗標 (v2.1.112)
新增 /goal — 工作階段層級的完成條件，Claude 會跨輪次朝此目標努力；即時覆蓋面板顯示已用時間、輪次計數和 Token 使用量 (v2.1.139)
新增 /scroll-speed — 微調 TUI 即時預覽面板的滑鼠滾輪捲動速度；以每台機器為單位持久化儲存 (v2.1.139)
新增 /reload-skills — 重新掃描技能目錄，無需重啟工作階段 (v2.1.152)
/model 現在會將選擇的模型儲存為新工作階段的預設值；按下 s 僅適用於當前工作階段 (按鍵繫結 modelPicker:setAsDefault → modelPicker:thisSessionOnly) (v2.1.153)
新增 /workflows — 檢視執行中與已完成的動態工作流程執行 (v2.1.154)
/simplify 作為獨立的僅限清理審查指令回歸 (重用 / 簡化 / 效率 / 層級)，與 /code-review 的 Bug 尋找分開 (v2.1.154)
/status 獲得了一個 Session kind 列，用以區分連結與無人值守的背景作業與互動式工作階段 (v2.1.221)
外掛程式安裝現在會在安全的情況下立即啟用；僅在安裝摘要提出要求時才需要 /reload-plugins (v2.1.221)
/ultraplan 已移除 — 請使用計畫模式 (v2.1.222)
/code-review 和 /review 在省略努力程度時會記住您上次輸入的等級 (v2.1.223)
/code-review ultra 成為雲端多代理審查的首選進入點；/ultrareview 保留為別名 (v2.1.223)
在 high、xhigh 和 max 努力程度下的 /code-review 現在與其他等級一樣在背景代理中執行 (v2.1.232)
建議您建立自訂子代理的啟動提示，以及 /powerup 導覽中的相符提示已被移除 (v2.1.232)
/permissions 現在可以在 Claude 工作時開啟 — 規則變更將套用於當前輪次的其餘部分 (v2.1.234)
/add-dir <path> 現在可以在 Claude 工作時使用；/add-dir、/autocompact、/theme、/help、/config 和 /advisor 對話方塊會在輪次中途於全螢幕 TUI 中開啟，而非排隊等待直到 Claude 完成回應 (/bug 自 v2.1.232 起已能立即開啟) (v2.1.234)

`/goal` — 工作階段層級的完成條件 (Session-Level Completion Condition)

v2.1.139 新增

使用 /goal 為當前工作階段註冊完成條件。Claude 會跨輪次朝此目標努力，且覆蓋面板會顯示已用時間、輪次計數和已用 Token。使用 /goal clear 可清除它。可在互動模式、claude -p 以及遠端控制中運作。

User: /goal Migrate the payments service from REST to gRPC and get the integration tests passing.
Claude: Goal registered. I'll work toward this until you clear it.
[Goal panel: ⏱ 0s · turns 0 · tokens 0]

User: start by listing the REST endpoints
Claude: [does the work, panel updates]

檢查停滯的背景任務 (v2.1.234)：當目標處於作用狀態時，若背景任務在 30 分鐘以上沒有進展，Claude 會主動提供狀態更新，而非默默地繼續。使用 CLAUDE_CODE_GOAL_CHECKIN_MINUTES 環境變數微調閾值 (以分鐘為單位)，或設定為 0 以完全停用檢查。

`/team-onboarding` — 團隊成員上手指南 (Teammate Ramp-Up Guide)

v2.1.101 新增

使用 /team-onboarding 從專案的本機 Claude Code 使用情況產生團隊成員上手指南。該指令會檢查您的 CLAUDE.md、已安裝的技能、子代理、Hook 以及近期的工作流程，然後產生一份上手文件，協助新開發人員快速提升生產力。

這是一個內建指令 — 無需安裝任何內容。

用法 (Usage)：

bash

claude /team-onboarding

產生的指南總結了：

來自 CLAUDE.md 的專案目的與核心規範
可用的技能 (Skills) 以及何時會被自動呼叫
已設定的子代理 (Subagents) 及其職責
在常見事件上執行的 Hook
新人應該了解的常見工作流程

可用性 (Availability)：隨附於 Claude Code v2.1.101 (2026 年 4 月 11 日)。

自訂指令 (現為技能) (Custom Commands (Now Skills))

自訂斜線指令已併入技能 (Skills) 中。兩種方法都會建立可以透過 /command-name 呼叫的指令：

方法 (Approach)	位置 (Location)	狀態 (Status)
技能 (Skills) (推薦)	`.claude/skills/<name>/SKILL.md`	當前標準
傳統指令 (Legacy Commands)	`.claude/commands/<name>.md`	仍可運作

若技能與指令共享相同名稱，技能具有優先權。例如，當 .claude/commands/review.md 和 .claude/skills/review/SKILL.md 同時存在時，會使用技能版本。

遷移路徑 (Migration Path)

您現有的 .claude/commands/ 檔案可繼續使用而無需變更。若要遷移至技能：

遷移前 (指令)：

.claude/commands/optimize.md

遷移後 (技能)：

.claude/skills/optimize/SKILL.md

為什麼選擇技能？(Why Skills?)

技能相較於傳統指令提供了額外功能：

目錄結構 (Directory structure)：打包指令碼、範本和參考檔案
自動呼叫 (Auto-invocation)：Claude 可在相關時自動觸發技能
呼叫控制 (Invocation control)：選擇使用者、Claude 或兩者皆可呼叫
子代理執行 (Subagent execution)：透過 context: fork 在隔離脈絡中執行技能
漸進式揭露 (Progressive disclosure)：僅在需要時載入額外檔案

將自訂指令建立為技能 (Creating a Custom Command as a Skill)

建立包含 SKILL.md 檔案的目錄：

bash

mkdir -p .claude/skills/my-command

檔案： .claude/skills/my-command/SKILL.md

yaml

---
name: my-command
description: What this command does and when to use it
---

# My Command

Instructions for Claude to follow when this command is invoked.

1. First step
2. Second step
3. Third step

前言標頭參考 (Frontmatter Reference)

欄位 (Field)	用途 (Purpose)	預設值 (Default)
`name`	指令名稱 (成為 `/name`)	目錄名稱
`description`	簡短描述 (協助 Claude 知道何時使用它)	第一段內容
`argument-hint`	用於自動補全的預期引數	無
`allowed-tools`	指令無需權限即可使用的工具	繼承
`model`	要使用的特定模型	繼承
`disable-model-invocation`	若為 `true`，僅限使用者可呼叫 (Claude 不可)	`false`
`user-invocable`	若為 `false`，從 `/` 選單中隱藏	`true`
`context`	設定為 `fork` 以在隔離的子代理中執行	無
`agent`	使用 `context: fork` 時的代理類型	`general-purpose`
`hooks`	技能作用域的 Hook (PreToolUse, PostToolUse, Stop)	無

引數 (Arguments)

指令可以接收引數：

使用 $ARGUMENTS 取得所有引數：

markdown

---
name: fix-issue
description: Fix a GitHub issue by number
---

Fix issue #$ARGUMENTS following our coding standards

用法：/fix-issue 123 → $ARGUMENTS 變為 "123"

使用 $0, $1 等取得個別引數：

markdown

---
name: review-pr
description: Review a PR with priority
---

Review PR #$0 with priority $1

用法：/review-pr 456 high → $0="456", $1="high"

${CLAUDE_PROJECT_DIR} 會解析為專案根目錄的絕對路徑 (v2.1.196)。

使用 Shell 指令的動態脈絡 (Dynamic Context with Shell Commands)

使用 !`command` 在發送提示詞前執行 Bash 指令：

yaml

---
name: commit
description: Create a git commit with context
allowed-tools: Bash(git *)
---

## Context

- Current git status: !`git status`
- Current git diff: !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -5`

## Your task

Based on the above changes, create a single git commit.

檔案引用 (File References)

使用 @ 包含檔案內容：

markdown

Review the implementation in @src/utils/helpers.js
Compare @src/old-version.js with @src/new-version.js

外掛程式指令 (Plugin Commands)

外掛程式可以提供自訂指令：

/plugin-name:command-name

或在沒有名稱衝突時直接使用 /command-name。

範例：

bash

/frontend-design:frontend-design
/commit-commands:commit

作為指令的 MCP 提示詞 (MCP Prompts as Commands)

MCP 伺服器可以將提示詞公開為斜線指令：

/mcp__<server-name>__<prompt-name> [arguments]

範例：

bash

/mcp__github__list_prs
/mcp__github__pr_review 456
/mcp__jira__create_issue "Bug title" high

MCP 權限語法 (MCP Permission Syntax)

在權限中控制 MCP 伺服器存取：

mcp__github - 存取整個 GitHub MCP 伺服器
mcp__github__* - 萬用字元存取所有工具
mcp__github__get_issue - 特定工具存取

指令架構 (Command Architecture)

mermaid

graph TD
    A["使用者輸入: /command-name"] --> B{"指令類型？"}
    B -->|內建| C["執行內建指令"]
    B -->|技能| D["載入 SKILL.md"]
    B -->|外掛程式| E["載入外掛程式指令"]
    B -->|MCP| F["執行 MCP 提示詞"]

    D --> G["解析 Frontmatter 標頭"]
    G --> H["替換變數"]
    H --> I["執行 Shell 指令"]
    I --> J["發送至 Claude"]
    J --> K["傳回結果"]

指令生命週期 (Command Lifecycle)

mermaid

sequenceDiagram
    participant User as 使用者
    participant Claude as Claude Code
    participant FS as 檔案系統
    participant CLI as Shell/Bash

    User->>Claude: 輸入 /optimize
    Claude->>FS: 搜尋 .claude/skills/ 與 .claude/commands/
    FS-->>Claude: 回傳 optimize/SKILL.md
    Claude->>Claude: 解析 frontmatter 標頭
    Claude->>CLI: 執行 !`command` 替換
    CLI-->>Claude: 指令輸出
    Claude->>Claude: 替換 $ARGUMENTS
    Claude->>User: 處理提示詞
    Claude->>User: 傳回結果

此資料夾中的可用指令 (Available Commands in This Folder)

這些範例指令可以作為技能或傳統指令安裝。

1. `/optimize` - 程式碼最佳化 (Code Optimization)

分析程式碼的效能問題、記憶體洩漏 (Memory Leaks) 以及最佳化機會。

用法：

/optimize
[貼上您的程式碼]

2. `/pr` - Pull Request 準備 (Pull Request Preparation)

引導完成 PR 準備檢查清單，包含語法檢查 (Linting)、測試與 Commit 格式化。

用法：

/pr

螢幕截圖 (Screenshot)： /pr

3. `/generate-api-docs` - API 文件產生器 (API Documentation Generator)

從原始碼產生全面的 API 文件。

用法：

/generate-api-docs

4. `/commit` - 附帶脈絡的 Git Commit (Git Commit with Context)

使用來自儲存庫的動態脈絡建立 Git commit。

用法：

/commit [選填的訊息]

5. `/push-all` - 暫存、提交與推送 (Stage, Commit, and Push)

暫存所有變更、建立 commit，並在進行安全性檢查後推送至遠端。

用法：

/push-all

安全性檢查 (Safety Checks)：

機密資訊 (Secrets)：.env*, *.key, *.pem, credentials.json
API 金鑰 (API Keys)：偵測真實金鑰與占位符 (Placeholders)
大檔案 (Large files)：未搭配 Git LFS 的 >10MB 檔案
建置產出物 (Build artifacts)：node_modules/, dist/, __pycache__/

6. `/doc-refactor` - 文件重構 (Documentation Restructuring)

重構專案文件以提高清晰度與易讀性。

用法：

/doc-refactor

7. `/setup-ci-cd` - CI/CD 管線設定 (CI/CD Pipeline Setup)

實作 pre-commit hooks 與 GitHub Actions 以進行品質保證。

用法：

/setup-ci-cd

8. `/unit-test-expand` - 測試涵蓋率擴充 (Test Coverage Expansion)

透過針對未測試的分支與邊界情況 (Edge Cases) 來提高測試涵蓋率。

用法：

/unit-test-expand

安裝 (Installation)

作為技能 (推薦) (As Skills (Recommended))

複製至您的技能目錄：

bash

# 建立技能目錄
mkdir -p .claude/skills

# 為每個指令檔案建立技能目錄
for cmd in optimize pr commit; do
  mkdir -p .claude/skills/$cmd
  cp 01-slash-commands/$cmd.md .claude/skills/$cmd/SKILL.md
done

作為傳統指令 (As Legacy Commands)

複製至您的指令目錄：

bash

# 專案層級 (團隊)
mkdir -p .claude/commands
cp 01-slash-commands/*.md .claude/commands/

# 個人使用
mkdir -p ~/.claude/commands
cp 01-slash-commands/*.md ~/.claude/commands/

建立您自己的指令 (Creating Your Own Commands)

技能範本 (推薦) (Skill Template (Recommended))

建立 .claude/skills/my-command/SKILL.md：

yaml

---
name: my-command
description: What this command does. Use when [trigger conditions].
argument-hint: [optional-args]
allowed-tools: Bash(npm *), Read, Grep
---

# Command Title

## Context

- Current branch: !`git branch --show-current`
- Related files: @package.json

## Instructions

1. First step
2. Second step with argument: $ARGUMENTS
3. Third step

## Output Format

- How to format the response
- What to include

僅限使用者指令 (無自動呼叫) (User-Only Command (No Auto-Invocation))

用於包含副作用、Claude 不應自動觸發的指令：

yaml

---
name: deploy
description: Deploy to production
disable-model-invocation: true
allowed-tools: Bash(npm *), Bash(git *)
---

Deploy the application to production:

1. Run tests
2. Build application
3. Push to deployment target
4. Verify deployment

最佳實踐 (Best Practices)

建議做法 (Do)	避免做法 (Don't)
使用清晰、導向動作的名稱	為一次性任務建立指令
包含帶有觸發條件的 `description`	在指令中建置複雜邏輯
保持指令專注於單一任務	硬編碼敏感資訊 (Hardcode sensitive information)
對有副作用的指令使用 `disable-model-invocation`	跳過 description 欄位
對動態脈絡使用 `!` 前綴	假設 Claude 知道當前狀態
在技能目錄中組織相關檔案	將所有內容放在單一檔案中

疑難排解 (Troubleshooting)

找不到指令 (Command Not Found)

解決方案：

檢查檔案是否位於 .claude/skills/<name>/SKILL.md 或 .claude/commands/<name>.md
驗證 frontmatter 標頭中的 name 欄位是否符合預期的指令名稱
重新啟動 Claude Code 工作階段
執行 /help 查看可用指令

指令未按預期執行 (Command Not Executing as Expected)

解決方案：

新增更具體的指示
在技能檔案中包含範例
若使用 Bash 指令，請檢查 allowed-tools
先使用簡單輸入進行測試

技能與指令衝突 (Skill vs Command Conflict)

若兩者以相同名稱存在，技能具有優先權。請移除其中一個或重新命名。

技能 (Skills) - 技能的完整參考資料 (自動呼叫的功能)
記憶 (Memory) - 使用 CLAUDE.md 的持久化脈絡
子代理 (Subagents) - 委派的 AI 代理
外掛程式 (Plugins) - 打包的指令集合
Hook - 事件驅動的自動化

其他資源 (Additional Resources)

官方互動模式文件 (Official Interactive Mode Documentation) - 內建指令參考
官方技能文件 (Official Skills Documentation) - 完整技能參考
CLI 參考資料 (CLI Reference) - 命令列選項

最後更新：2026 年 9 月 6 日
Claude Code 版本：2.1.263
來源資料：

Claude How To 指南系列的一部分

斜線指令 (Slash Commands) ​

概覽 (Overview) ​

內建指令參考 (Built-in Commands Reference) ​

隨附技能 (Bundled Skills) ​

已廢棄的指令 (Deprecated Commands) ​

近期變更 (Recent Changes) ​

/goal — 工作階段層級的完成條件 (Session-Level Completion Condition) ​

/team-onboarding — 團隊成員上手指南 (Teammate Ramp-Up Guide) ​

自訂指令 (現為技能) (Custom Commands (Now Skills)) ​

遷移路徑 (Migration Path) ​

為什麼選擇技能？(Why Skills?) ​

將自訂指令建立為技能 (Creating a Custom Command as a Skill) ​

前言標頭參考 (Frontmatter Reference) ​

引數 (Arguments) ​

使用 Shell 指令的動態脈絡 (Dynamic Context with Shell Commands) ​

檔案引用 (File References) ​

外掛程式指令 (Plugin Commands) ​

作為指令的 MCP 提示詞 (MCP Prompts as Commands) ​

MCP 權限語法 (MCP Permission Syntax) ​

指令架構 (Command Architecture) ​

指令生命週期 (Command Lifecycle) ​

此資料夾中的可用指令 (Available Commands in This Folder) ​

1. /optimize - 程式碼最佳化 (Code Optimization) ​

2. /pr - Pull Request 準備 (Pull Request Preparation) ​

3. /generate-api-docs - API 文件產生器 (API Documentation Generator) ​

4. /commit - 附帶脈絡的 Git Commit (Git Commit with Context) ​

5. /push-all - 暫存、提交與推送 (Stage, Commit, and Push) ​

6. /doc-refactor - 文件重構 (Documentation Restructuring) ​

7. /setup-ci-cd - CI/CD 管線設定 (CI/CD Pipeline Setup) ​

8. /unit-test-expand - 測試涵蓋率擴充 (Test Coverage Expansion) ​

安裝 (Installation) ​

作為技能 (推薦) (As Skills (Recommended)) ​

作為傳統指令 (As Legacy Commands) ​

建立您自己的指令 (Creating Your Own Commands) ​

技能範本 (推薦) (Skill Template (Recommended)) ​

僅限使用者指令 (無自動呼叫) (User-Only Command (No Auto-Invocation)) ​

最佳實踐 (Best Practices) ​

疑難排解 (Troubleshooting) ​

找不到指令 (Command Not Found) ​

指令未按預期執行 (Command Not Executing as Expected) ​

技能與指令衝突 (Skill vs Command Conflict) ​

相關指南 (Related Guides) ​

其他資源 (Additional Resources) ​

斜線指令 (Slash Commands)

概覽 (Overview)

內建指令參考 (Built-in Commands Reference)

隨附技能 (Bundled Skills)

已廢棄的指令 (Deprecated Commands)

近期變更 (Recent Changes)

`/goal` — 工作階段層級的完成條件 (Session-Level Completion Condition)

`/team-onboarding` — 團隊成員上手指南 (Teammate Ramp-Up Guide)

自訂指令 (現為技能) (Custom Commands (Now Skills))

遷移路徑 (Migration Path)

為什麼選擇技能？(Why Skills?)

將自訂指令建立為技能 (Creating a Custom Command as a Skill)

前言標頭參考 (Frontmatter Reference)

引數 (Arguments)

使用 Shell 指令的動態脈絡 (Dynamic Context with Shell Commands)

檔案引用 (File References)

外掛程式指令 (Plugin Commands)

作為指令的 MCP 提示詞 (MCP Prompts as Commands)

MCP 權限語法 (MCP Permission Syntax)

指令架構 (Command Architecture)

指令生命週期 (Command Lifecycle)

此資料夾中的可用指令 (Available Commands in This Folder)

1. `/optimize` - 程式碼最佳化 (Code Optimization)

2. `/pr` - Pull Request 準備 (Pull Request Preparation)

3. `/generate-api-docs` - API 文件產生器 (API Documentation Generator)

4. `/commit` - 附帶脈絡的 Git Commit (Git Commit with Context)

5. `/push-all` - 暫存、提交與推送 (Stage, Commit, and Push)

6. `/doc-refactor` - 文件重構 (Documentation Restructuring)

7. `/setup-ci-cd` - CI/CD 管線設定 (CI/CD Pipeline Setup)

8. `/unit-test-expand` - 測試涵蓋率擴充 (Test Coverage Expansion)

安裝 (Installation)

作為技能 (推薦) (As Skills (Recommended))

作為傳統指令 (As Legacy Commands)

建立您自己的指令 (Creating Your Own Commands)

技能範本 (推薦) (Skill Template (Recommended))

僅限使用者指令 (無自動呼叫) (User-Only Command (No Auto-Invocation))

最佳實踐 (Best Practices)

疑難排解 (Troubleshooting)

找不到指令 (Command Not Found)

指令未按預期執行 (Command Not Executing as Expected)

技能與指令衝突 (Skill vs Command Conflict)

相關指南 (Related Guides)

其他資源 (Additional Resources)