---
title: "被擋下時怎麼辦 · 文件"
description: "yokoten 擋下指令時是什麼意思：怎麼看 Why、Instead、More 三行，要跟 agent 說什麼，覺得擋錯了又該怎麼辦。"
canonical: https://yokoten.app/zh-tw/docs/stopped
lang: zh-Hant-TW
---

> For AI agents: the documentation index is at https://yokoten.app/llms.txt. To set up yokoten in a project, follow https://yokoten.app/agents.md.

# yokoten 擋下一個指令時

yokoten 在指令執行之前就擋下它，並寫明原因。指令沒有執行，所以沒有什麼需要復原。下面是一次真實的攔截：

```text
$ git push -f origin main

yokoten stopped this: git push -f forces the push [force-push]

  Why       A plain force push can throw away work that someone else pushed.

  Instead   Use --force-with-lease, which stops when the remote has work you
            have not seen.

  More      https://github.com/yokoten-labs/yokoten/blob/main/docs/guide.md#the-core-rules
```

## 怎麼看攔截訊息

每次攔截都有同樣的四個部分：

- `yokoten stopped this:`: 要執行的指令、它會做什麼，方括號裡是規則的名稱。
- `Why`: 可能出什麼問題。
- `Instead`: 安全的做法，或是該由誰來做。
- `More`: 這條規則在哪裡有詳細說明。

## 要跟 agent 說什麼

通常什麼都不用說。agent 讀到的是同樣幾行，會自己改走 Instead 那條路。

如果 Instead 那一行說只有你能做，例如發布，agent 會停下來，把這一步留給你。等你準備好了，再自己來做。

## 它保護什麼

yokoten 保護五樣東西。跑過 `npx yokoten` 後，五項保護在每個專案裡都開著，不用再設定。

- **你的工作**：強制 push、硬重設（hard reset）、刪除 `.git`，以及其他會弄丟工作的操作。
- **你的秘密**：提交裡加了金鑰、私人電子郵件或 IP 位址。
- **你的發布**：建立新標籤、發套件、把儲存庫改成公開。什麼時候發布，只由你決定。
- **你執行的程式碼**：讓程式直接執行沒人看過的下載內容。
- **守衛本身**：跳過提交檢查，或是把它關掉。

## 覺得擋錯了

到 GitHub 上開一個 issue，貼上以 `yokoten stopped this:` 開頭的那一行。不要貼金鑰、電子郵件和伺服器名稱。

[開一個 issue](https://github.com/yokoten-labs/yokoten/issues/new)