# SKILL-020 — 操作員手冊比對系統（一鍵部署）

> 把下面的指令貼到你的 **general 頻道**，機器人就會自動幫你建好整套比對系統。

---

## 快速開始（貼這段到 general 頻道）

```
請幫我建立操作員手冊比對系統，需要以下 4 個機器人：

1. 建立 file-reader（文件比對）
   - 角色：讀取 Word/PDF 手冊，依照 SOP Priority 1-5 執行完整比對
   - SOP 參考：https://skills-sop.pages.dev/operator-manual-sop.md

2. 建立 word-bot（文字修改）
   - 角色：收到問題清單後，搜尋確認→用戶確認→執行替換→產出修改後檔案

3. 建立 qa-checker（QA 驗證）
   - 角色：獨立抽查 file-reader 的報告，確認每個 Priority 都執行、數據正確。未通過→打回補做

4. 建立 ocr-reader（截圖文案讀取）
   - 角色：讀取遊戲截圖中的所有文字，一個都不可以漏

建好後請把 SOP 內容發給 file-reader 和 qa-checker，讓它們知道比對規則。
```

---

## 建好後怎麼用

### 比對手冊（3 步驟）

**Step 1：上傳檔案到 file-reader 頻道**

把以下兩份檔案傳到 file-reader 的頻道：
- 要比對的手冊（Word 或 PDF）
- 基準版手冊（如簡體版 PDF）

然後說：
```
請依照 SOP 比對這份繁體手冊，基準版是附件的 PDF。
重點：
1. 不可有簡體中文
2. LOGO 不可放錯遊戲
3. 章節圖文要一致
4. 每一個字都要比對
```

**Step 2：等待結果（約 10-20 分鐘）**

file-reader 會自動執行所有 Priority，qa-checker 會自動驗證。
完成後你會收到報告，格式如下：
- 🔴 Critical — 必須修正
- 🟡 Warning — 建議修正
- ℹ️ Info — 告知（不算錯）

**Step 3：修正問題（如果有）**

把問題清單貼到 word-bot 頻道，說：
```
請修正以下問題：
1. 「主菜單」→「主選單」（52處）
2. 「氮氣鍵」→「Start鍵」（7處）
```

word-bot 會先回報搜尋結果讓你確認，確認後才執行修改。

---

## SOP 比對項目（完整清單）

| Priority | 項目 | 說明 |
|----------|------|------|
| 1 | 逐字比對 | 每一個字和基準版對照，確認無簡體殘留 |
| 1.5 | 選單架構 vs 章節標題 | 選單架構頁的名稱必須和章節標題逐字一致 |
| 2 | 三者對照 | 標題 = 截圖 = 內文，三者完全一致 |
| 3 | 圖文比對 | 逐頁讀取截圖文字，和正文比對 |
| 3.5 | LOGO 驗證 | 全頁面掃描（1-2頁/次），確認 LOGO 屬於正確遊戲 |
| 3.7 | 截圖語言一致 | 繁體手冊的截圖不可有簡體字 |
| 4 | 目錄頁碼 | 目錄標示的頁碼和實際頁碼一致 |
| 4.5 | 交叉引用 | 「見第X頁」的引用是否指向正確位置 |
| 5 | 圖片數量 | 每章截圖數量和文字描述一致 |
| 5.5 | 版本資訊 | 版本號、日期、客服電話是否正確 |

---

## 支援的遊戲

| 遊戲 | LOGO 特徵 | 操控鍵 |
|------|-----------|--------|
| A8+ 閃電摩托 | MOTOBLITZ + 摩托車 + A8PLUS 版號 | 氮氣鍵 |
| A9+ 狂野飆車 | ASPHALT 9 + 賽車 + A9PLUS 版號 | Start鍵 |

---

## 支援的語言版本

| 版本 | 檢查重點 |
|------|---------|
| 繁體中文 | 不可有簡體殘留，用語：主選單/平台/連線/還原出廠 |
| 簡體中文 | 不可有繁體殘留，用語：主菜單/平台 |
| 英文 | 不可有中文殘留，拼寫一致性 |

---

## 注意事項

1. **系統覆蓋率約 95-99%**，以下仍需人工確認：
   - 截圖中極小文字
   - 排版/格式問題
   - 語意正確但措辭不同的段落

2. **比對需要時間**（約 10-20 分鐘/份），請耐心等待，不要中途打斷

3. **不要在比對進行中修改檔案**

4. **報告結尾如果標示「需人工確認」的項目，請不要跳過**

---

## 機器人分工

| 機器人 | 你跟它說什麼 | 它會做什麼 |
|--------|-------------|-----------|
| **file-reader** | 「比對這份手冊」+ 上傳檔案 | 執行 Priority 1-5 全部比對，產出報告 |
| **word-bot** | 「修改這些問題」+ 問題清單 | 搜尋→確認→替換→產出修改後檔案 |
| **qa-checker** | 不需要你操作 | 自動驗證 file-reader 報告品質 |
| **ocr-reader** | 「讀取文案」+ 放截圖到資料夾 | 列出截圖中所有文字 |

---

## 常見問題

**Q：比對到一半卡住了怎麼辦？**
A：到 general 頻道說「file-reader 卡住了請確認」，general 會幫你處理。

**Q：報告說有 50 個問題，太多了怎麼辦？**
A：先看 🔴 Critical 的（通常只有幾個），🟡 Warning 可以之後再處理。

**Q：word-bot 改完後要怎麼確認改對了？**
A：跟 general 說「請 file-reader review 修改後的檔案」，它會重新檢查一遍。

**Q：可以同時比對兩份手冊嗎？**
A：可以，但建議一份一份來，避免混淆。

---

## 下載

- [📋 operator-manual-sop.md](operator-manual-sop.md) — 完整 SOP 規則檔案
- [📋 SKILL-020.md](SKILL-020.md) — 本頁 Markdown 版