TRPG Abbreviation Check (Rules)

SKILL.md

---
name: trpg-abbr-check-rules
description: "Use this skill when checking and fixing English abbreviations in TRPG rulebooks, scenarios, character sheets, catalogs, maps, and other player/GM-facing files (not briefing_package). Triggers on: check abbreviations in rules, fix English abbreviations in rulebook/scenarios/sheets, 規則英文縮寫檢查, 劇本縮寫檢查, 角色卡縮寫檢查."
agent_created: true
---

🔧 系統更新：檢查並替換規則與劇本中的英文縮寫（非 briefing_package 版本）

你正在撰寫的 TRPG 規則書、劇本、角色卡和相關文件中需要全面檢查英文縮寫，確保所有真人可能看到的遊戲術語都有中文全稱。

核心原則：
  真人玩家和真人 GM 都是人——他們看到「STR」「DEX」「HP」這些英文縮寫時不一定知道是什麼意思。無論是給玩家看的規則書還是給 GM 看的規則書，這都不是寫給程式看的技術文檔，是給真人閱讀的遊戲文件。

你需要檢查並修正的事：

1. 什麼樣的英文縮寫需要改
   - 遊戲術語：屬性名、技能名、狀態名、裝備名、怪物名——任何出現在遊戲文件中的詞
   - 格式要求：「中文全稱（縮寫）」。例如：
     ❌ 力量：決定物理攻擊力。STR 越高傷害越大。
     ✅ 力量（STR）：決定物理攻擊力。力量（STR）越高傷害越大。
   - 不只標題和定義要改，正文中每次出現也要用全稱——讀者可能在任意位置讀到
   - GM 規則書也不例外——GM 也是真人，看不懂縮寫的機率跟玩家一樣高

2. 什麼樣的英文可以保留不改
   - Excel 公式中的變數名和函數（如 FLOOR、SUM、IF 等 Excel 內建函數）
   - 純數值和數學公式
   - 檔案名稱（如「S1_劇本.yaml」中的 S1 前綴）
   簡單判斷：「這個詞會出現在任何真人會閱讀的遊戲文字中嗎？」
   - 會 → 必須補中文全稱
   - 不會 → 可以保留英文

3. GM 規則書和參考文件要特別注意
   - GM 規則書和圖鑑雖然是給 GM 參考的，但 GM 也是真人
   - GM 在主持遊戲時會直接查閱這些文件並向玩家轉述內容
   - 因此 GM 專用文件中的遊戲術語同樣必須使用「中文全稱（縮寫）」格式
   - 不要因為是 GM 文件就全用英文縮寫

4. 檢查範圍
   - 玩家規則書（.md）
   - GM 規則書（.md）
   - 所有劇本文件（scenarios/*.yaml 或 .md）
   - 所有 Excel 角色卡（.xlsx）中的文字標籤和說明
   - 物品圖鑑、怪物圖鑑等參考文件（.md 或 .yaml）
   - 地圖文件中的文字標籤（.yaml 或圖片中的文字）

5. 常見需要檢查的英文縮寫類別
   - 屬性（STR、DEX、CON、INT、WIS、CHA…）
   - 衍生值（HP、MP、SP、AC、DC…）
   - 狀態效果（Stun、Poison、Burn、Freeze、Bleed…）
   - 裝備稀有度（Common、Rare、Epic、Legendary…）
   - 傷害類型（Physical、Magic、Fire、Ice、Lightning、Holy、Dark…）
   - 技能類型（Active、Passive、Aura、Buff、Debuff…）
   - 檢定類型（Skill Check、Saving Throw、Attack Roll…）
   - 貨幣/資源（Gold、Silver、EXP、AP、SP…）

6. 屬性對照表的縮寫例外規則（僅限表格內）

在屬性對照表（或其他有「屬性中文名」欄位的表格）中，如果同一列的前一格已經是該屬性的中文全稱，則當前格的縮寫不重複包裝，直接用純縮寫。這是為了避免「根骨」和「根骨（GUG）」在同一列連續出現兩次。

適用此例外的縮寫：所有屬性縮寫均適用此例外規則（如 GUG、WUX、SHS 等——取決於當前規則自行定義的屬性縮寫）。不適用此例外的縮寫（仍照主規則包裝，即使在前一格已有中文名也照包）：HP、DC、CR、AC、TN、MoS、MoF、GS、EL、AOE 等所有非屬性的衍生值/系統縮寫。

判斷邏輯：對表格的每一列，從第 2 欄起逐一檢查——
  - 若當前格文字是「中文全稱（縮寫）」形式；
  - 且前一格去除 ** 粗體記號和空白後，正好等於那個中文全稱；
  - 就把當前格還原成純縮寫。

範例（Markdown 表格）：
  ❌ 根骨 | 根骨（GUG） | 修煉速度、突破檢定
  ✅ 根骨 | GUG | 修煉速度、突破檢定

範例（衍生值同理）：
  ❌ 生命值 | 生命值（HP） | 角色當前的生命值
  ✅ 生命值 | HP | 角色當前的生命值

⚠️ 只在同列已有中文全稱時才還原。若前一格不是該全稱，不要動。
⚠️ 繁簡必須一致才能觸發對應，屬性名一律使用繁體。

檢查方法：
  逐行掃讀所有文件。看到「括號內只有英文且沒有前導中文」的地方——
  這些就是需要補上中文全稱的位置。

⚠️ 過渡檔案提醒：只檢查最新版正式檔案。如果資料夾中有明顯的過渡檔案（如「舊版_」、「備份_」、「v1_」開頭，或檔名帶有「_old」「_bak」「草稿」等標記，或內容與正式檔案高度重複但已被正式檔案取代），不要浪費時間檢查和修改它們。

⚠️ 效率提示：英文縮寫替換通常涉及大量檔案。請同時讀取所有需要檢查的檔案，批量替換縮寫後同時寫回。所有檔案的縮寫規則一致，不需要逐個檔案逐行慢慢改。