> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# 指令

> AI 代理的內建斜線指令

指令是您可以從聊天輸入列叫用的內建動作。與[技能](/zh-Hant/ctor/reference/skills)相同，指令透過 `/` 觸發；但指令不會引用可重複使用的指示內容，而是直接對工作階段執行動作。

## 使用指令

在聊天輸入列開頭輸入 `/` 以開啟斜線彈出視窗。內建指令會以**內建**標籤排在最前，接著才是已安裝的技能。選取一個指令以插入輸入列，或繼續輸入後以一般訊息送出。

指令必須是訊息的第一個 token。在其他文字之後輸入 `/compact`——例如「/compact 是做什麼的？」——會被視為純文字，指令不會執行。

若您在代理仍在串流時送出指令，CTOR 會將其排入佇列，並在下一個對話回合邊界執行，而不會直接捨棄。

## 可用指令

### `/compact`

手動壓縮目前工作階段的對話歷史。當您想在抵達自動壓縮門檻前釋出上下文時使用——例如，在啟動長時間子任務之前。

CTOR 會以摘要取代較舊的訊息，同時保留最近幾輪對話。摘要訊息會出現在被壓縮歷史的位置；後續訊息則以縮短後的上下文繼續進行。

**接續提示。** 您可以在同一次送出中串接一段提示：

```
/compact 然後解釋我們剛剛做了什麼
```

CTOR 會先執行壓縮，再將後續文字作為新提示針對壓縮後的歷史送出。

**可用性。** 斜線彈出視窗會探測目前工作階段是否長到足以產生有意義的切點。若不足，`/compact` 項目會從彈出視窗中隱藏——您仍可手動輸入，但若沒有切點則不會發生任何動作。

**編輯先前訊息。** 將先前某則使用者訊息改寫為 `/compact` 並送出編輯，會把對話壓縮至該則訊息為止。編輯表單會捨棄 `/compact` 之後的任何尾隨文字，避免將動作拆成兩個操作。

### `/goal`

為目前工作階段設定一個持續性目標。代理會自動朝目標推進，在每一輪結束後評估進度，並持續執行直到目標完成。

```
/goal 建立一個含有電子郵件與密碼欄位的登入頁面
```

CTOR 會將目標作為第一個提示送出並開始作業。每一輪代理回合結束後，會透過輕量評估檢查目標是否完成：

* **完成** — 目標標記為已完成，聊天中會顯示完成通知。
* **未完成** — CTOR 記錄目前的進度原因、遞增回合數，並自動送出接續提示讓代理繼續作業。

目標儲存在訊息列表之外，因此可以在 `/compact`、自動壓縮及訊息編輯後繼續保留。一般的後續訊息與引導指令不會清除目標。

**狀態列。** 當目標處於啟用狀態時，輸入列上方會出現一個狀態列，顯示目標文字、已用時間、回合數以及最新的進度原因。該列包含**狀態**與**取消**按鈕。

**檢視狀態。** 輸入 `/goal` 且不帶任何參數，即可將狀態通知附加到聊天中：

```
/goal
```

**取消目標。** 輸入以下任一指令即可取消目前的目標並停止自動接續：

```
/goal cancel
/goal clear
/goal stop
/goal off
/goal reset
/goal none
```

您也可以按一下狀態列上的**取消**按鈕。

**排隊。** 若您在代理串流時送出 `/goal <目標>`，CTOR 會將其排入佇列，並在下一個對話回合邊界開始執行目標。狀態與取消操作即使在串流期間也會立即執行。

### `/plan`

進入[計畫模式](/zh-Hant/ctor/reference/plan-mode)，在代理修改程式碼前先草擬實作計畫。工作階段會變為唯讀—檔案寫入限制在 `plan/` 內，shell 指令在唯讀沙箱中執行，MCP 工具被封鎖—直到您核准計畫為止。

**附帶任務描述。** 接上任務描述可立即開始規劃：

```
/plan 為設定頁面加入深色模式支援
```

代理會探索程式碼庫，將結構化計畫寫入 `plan/`，並呈交供您核准。

**不附帶任務。** 單獨輸入 `/plan`，代理會詢問您想規劃什麼。

**執行既有計畫。** 以 `/plan execute`（或 `/plan run`）接上路徑，即可實作先前儲存的計畫：

```
/plan execute plan/2026-06-12-dark-mode.md
```

這會在一般的讀寫工作階段中執行，而非進入計畫模式：代理會先審查既有計畫，再進行實作。路徑相對於專案根目錄。

**退出。** 輸入 `/plan exit`（或 `off`、`cancel`、`stop`、`quit`）可在不核准計畫的情況下離開計畫模式。您也可以按一下訊息下方指示列上的 **Exit plan mode**。

<Card title="計畫模式" icon="list-check" href="/zh-Hant/ctor/reference/plan-mode">
  參閱計畫模式，了解完整工作流程：審查、核准、進度追蹤與執行限制的詳細資訊。
</Card>
