From 8152a8843af3fe411263d8566349b2584b91ddec Mon Sep 17 00:00:00 2001
From: "Alice (OpenClaw)" <alice@cowbay.org>
Date: Thu, 23 Apr 2026 11:42:02 +0800
Subject: [PATCH] Make README bilingual (zh-TW first, English after)

---
 README.md | 107 +++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 93 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index b8e77b5..4997ae6 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,100 @@
 # openclaw-auto-continue
 
+可重用的 OpenClaw skill，提供 `/auto-continue`（別名 `/ac`）的 session-level auto-followup 使用方式。
+
 Reusable OpenClaw skill for `/auto-continue` (`/ac`) session-level auto-followup.
 
-## What this repo contains
+## 繁體中文說明
 
+### 這個 repo 內有什麼
+- `openclaw-auto-continue/SKILL.md` — **給 Agent 看的** skill 指引
+- `openclaw-auto-continue.skill` — 已打包好的 skill 檔
+
+### 其他電腦怎麼用
+
+#### 方式 1：直接 clone repo
+```bash
+git clone https://gitea.cowbay.org/openclaw/openclaw-auto-continue.git
+cd openclaw-auto-continue
+```
+
+把 skill 資料夾放到目標機器的 OpenClaw skills 目錄：
+
+```bash
+mkdir -p ~/.openclaw/workspace/skills
+cp -R openclaw-auto-continue ~/.openclaw/workspace/skills/
+```
+
+#### 方式 2：直接用 `.skill` 檔
+如果目標 OpenClaw 環境已有 skill 匯入 / 安裝流程，就直接使用：
+
+- `openclaw-auto-continue.skill`
+
+### 在目標 OpenClaw 聊天 / session 裡怎麼開
+安裝 skill **不代表每個 chat 都會自動啟用**。
+你還是要在想啟用的那個 chat / session 裡手動開：
+
+```text
+/ac on
+```
+
+查狀態：
+
+```text
+/ac status
+```
+
+關閉：
+
+```text
+/ac off
+```
+
+### `/ac on` 之後會發生什麼
+開啟後，目前 session 會使用 followup 型續跑設定：
+
+- `queueMode = "followup"`
+- `queueDebounceMs = 0`
+- `queueCap = 1`
+- `queueDrop = "summarize"`
+
+實際效果：
+- agent 比較可能直接接著做下一個低風險步驟
+- 比較不容易每做一步就停下來
+- 適合在同一個 chat 中做多步任務
+
+### 重要邊界
+這是 **session-scoped**，不是全域開關。  
+如果你想在另一個 chat 生效，就要在那個 chat 再開一次。
+
+它也**不會**繞過：
+- approvals
+- safety checks
+- destructive action confirmation
+- user decision points
+
+### 給 Agent 看
+如果 OpenClaw agent 要判斷怎麼使用這個 repo：
+
+1. 讀 `openclaw-auto-continue/SKILL.md`
+2. 依照裡面的 trigger conditions 與 command usage 使用
+3. 在對應 chat / session 中使用 `/ac on`、`/ac off`、`/ac status`
+
+一句話：
+- `README.md` 是給人 / operator 看的
+- `openclaw-auto-continue/SKILL.md` 是給 agent 看的
+
+---
+
+## English
+
+### What this repo contains
 - `openclaw-auto-continue/SKILL.md` — the **agent-facing** skill instructions
 - `openclaw-auto-continue.skill` — packaged skill artifact
 
-## For humans: how to use on another computer
-
-### Option 1: clone the repo
+### For humans: how to use on another computer
 
+#### Option 1: clone the repo
 ```bash
 git clone https://gitea.cowbay.org/openclaw/openclaw-auto-continue.git
 cd openclaw-auto-continue
@@ -23,14 +107,12 @@ mkdir -p ~/.openclaw/workspace/skills
 cp -R openclaw-auto-continue ~/.openclaw/workspace/skills/
 ```
 
-### Option 2: use the packaged `.skill` file
-
+#### Option 2: use the packaged `.skill` file
 If your target OpenClaw environment already has a skill import/install flow, use:
 
 - `openclaw-auto-continue.skill`
 
-## On the target OpenClaw chat/session
-
+### On the target OpenClaw chat/session
 Installing the skill does **not** automatically enable auto-continue for every chat.
 You still need to turn it on in the specific chat/session where you want it active:
 
@@ -50,8 +132,7 @@ Turn it off:
 /ac off
 ```
 
-## What changes after `/ac on`
-
+### What changes after `/ac on`
 When enabled, the current session uses followup-style continuation behavior:
 
 - `queueMode = "followup"`
@@ -64,8 +145,7 @@ Practical effect:
 - the agent is less likely to stop after every intermediate update
 - this is good for multi-step execution in the same chat
 
-## Important boundary
-
+### Important boundary
 This is **session-scoped**, not global.
 If you want it active in a different chat, enable it in that chat too.
 
@@ -75,8 +155,7 @@ It also does **not** bypass:
 - destructive action confirmation
 - user decision points
 
-## For agents
-
+### For agents
 If an OpenClaw agent is deciding how to use this repo:
 
 1. Read `openclaw-auto-continue/SKILL.md`