← 返回索引

Skill: 操作員選單文件 SOP

> 適用於大型機台遊戲（A8+ 閃電摩托、A9+ 狂野飆車等）的操作員手冊檢查與修正流程。

---

完整流程圖

用戶提供文件（Word/PDF）+ 基準版
        ↓
[file-reader] 階段 1：全文比對
        ↓
[file-reader] 階段 2：上下文一致性檢查
        ↓
[file-reader] 階段 3：圖文比對（逐頁）
        ↓
[file-reader] 階段 4：圖片數量比對
        ↓
產出問題報告 → 用戶確認
        ↓
[word-bot] 階段 1：搜尋標記（回報匹配數+上下文）→ 用戶確認
        ↓
[word-bot] 階段 2：執行修改 + 對比報告 → 傳回修改後檔案
        ↓
用戶確認是否需要 review
        ↓
[file-reader] Review：驗證修改正確性 → 產出 Review 報告
        ↓
用戶做最終決策（通過 / 再修改）

---

file-reader 檢查規範

⚠️ 執行標準（必讀）

「逐字」= 每一句、每一個詞、每一個字母。不可以為省時間降低精度。

每次比對報告的最前面必須附上 SOP 執行檢查表：

📋 SOP 執行確認：
☑️ Priority 1：逐段文字比對（共 X 段，全部完成）
☑️ Priority 2：名詞一致性（標題 vs 截圖 vs 內文，共 X 個名詞）
☑️ Priority 3：逐頁圖文比對（共 X 頁，subagent 分批完成）
☑️ Priority 4：表格/列表完整性
☑️ Priority 5：大圖數量比對

如果某個 Priority 沒做到，必須標 ❌ 並說明原因。

---

Priority 1 — 逐字比對（需基準版）

• 每一行、每一個字和基準版比對
• 缺少任何一個字都要報告
• 不限於「明顯差異」
• 「逐字」= 每一段文字都要有對應，不是只比章節存不存在
• 每段描述是否完整（有沒有漏翻、漏寫的句子）

Priority 2 — 上下文一致性（三者一致）

• 每個章節必須比對「標題 vs 截圖 vs 內文」三者完全一致
• 例：標題寫 "Coin Option Setting" → 截圖也必須是 "Coin Option Setting" → 內文也必須是 "Coin Option Setting"
• 差異包含：單複數（Setting vs Settings）、大小寫、空格、拼字
• 同一詞彙每次出現都必須一致（如「氮气」不能有地方只寫「氮」）
• 括號【】內文字必須和實際選單項目名稱完全一致
• 選單路徑中每個項目名稱都要核實

必須逐章節產出對照表：

| 章節 | 標題寫法 | 截圖顯示 | 內文寫法 | 結果 |

Priority 3 — 圖文完全比對（必須用 subagent 讀取截圖）

• 必須用 pdftoppm 轉圖片，再用 subagent 逐頁讀取截圖中的文字
• 不可以只比對純文字，必須實際「看」截圖圖片內容
• 逐頁掃描，截圖中每個可見文字都和正文比對
• 表格項目名稱、欄位標題和截圖一致
• 文案中「按下【X】鍵」和截圖底部操作提示一致
• 用 subagent 分批處理（每批 5-10 頁）
• 不可跳過任何頁面
• 不可用「表格比對」代替「截圖讀取」— 兩者都要做

Priority 4 — 表格/列表完整性

• 表格每個項目名稱和說明逐字確認
• 列表編號連續且正確

Priority 5 — 圖片數量比對

• 只計算大圖（寬度 > 400px 且高度 > 300px）
• 忽略小圖標、bullet point、裝飾圖
• 以各自文件為基準（不跨遊戲比較章節存不存在）
• 比對「文字描述的步驟數」vs「實際截圖數」
• 如果文字提到「如下圖」但沒有圖 → 報告缺圖

跨遊戲比對注意事項

• 不同遊戲有各自獨有功能（如 A9+ 有力回饋、安全帶；A8+ 有踏板感測）
• 不要因為一方有某章節而另一方沒有就標記錯誤
• 只比對「同一章節內部」是否完整

報告格式

每個問題必須包含：

• 頁碼
• 確切位置（段落/表格/截圖）
• 錯誤內容
• 正確內容
• 問題類型（缺字/一致性/圖文不一致/編號錯誤/缺圖）

---

word-bot 修改規範

兩階段流程

階段 1：搜尋標記

• 收到替換清單後，先搜尋所有目標文字
• 回報每項的匹配數量和上下文
• 匹配為 0 的標記「⚠️ 未找到」
• 等用戶確認後才進入階段 2

階段 2：執行修改 + 驗證報告

• 執行替換
• 產出修改前後對比報告
• 附上修改後的檔案

圖片替換規範

1. 直接替換 docx zip 中的圖片檔案（不經過壓縮）

2. 調整 document.xml 中 wp:extent 和 a:ext 的 cx/cy 值

3. 保持高度不變、按新圖實際寬高比縮小寬度

4. 確保不變形、不失真

圖片編輯能力

• 用 Pillow 在截圖上加文字（版號、標註）
• 用黑色矩形覆蓋錯誤文字
• 字型：Courier New 或 DejaVu Sans Mono
• 根據圖片尺寸等比例調整文字位置和大小

---

Review 階段（file-reader）

當 word-bot 完成修改後，用戶可要求 review：

1. 逐項核對之前報告的問題是否都已修正

2. 確認沒有引入新問題

3. 產出 Review 報告

報告格式：

📋 Review 結果

✅ 已修正：
#1 xxx ✅
#2 xxx ✅

❌ 未修正或新問題：
#5 仍然存在「xxx」

結論：✅ 全部通過 / ❌ 仍需修改

用戶是最終決策者 — Review 結果僅供參考。

---

問題分類與處理

類型	處理方式	負責
文字缺字/錯字	word-bot 文字替換	word-bot
繁體字殘留	word-bot 文字替換	word-bot
選單編號錯誤	word-bot 文字替換	word-bot
圖片中文字錯誤	word-bot 圖片編輯覆蓋	word-bot
截圖需重新擷取	用戶手動截圖 → word-bot 替換	用戶 + word-bot
版號需加入截圖	word-bot 圖片編輯	word-bot

---

截圖替換流程

1. file-reader 產出截圖清單（章節、步驟、操作說明、預期畫面、建議檔名）

2. 用戶按清單在遊戲中截圖

3. 用戶傳圖到 word-bot 頻道，標明對應位置（如 p20_1.png）

4. word-bot 用 zip 替換方式插入，保持比例不變形

---

涉及的機器人

機器人	角色
general	協調、轉交、監控進度
file-reader	文件分析、比對、Review
word-bot	文字修改、圖片編輯、圖片替換