latex-precompile

name	latex-precompile
description	LaTeX source 編譯前的 static check — punct_check（半形/全形標點）+ fonts_check（字型缺字，需既有 .log）+ source-level pattern audit。當用戶說「precompile check」「編譯前檢查」「跑 make check」「source audit」「掃半形標點」「掃缺字」時使用。對應暑期班 typesetting-checklist 的

LaTeX Precompile Check

編譯之前先跑 source-level static check，把「編譯出來才會發現」的 bug 提前抓出來。比 make check 工作流更省事的單一 skill。

Trigger

用戶說：

• 「precompile check」「編譯前檢查」「source audit」
• 「跑 make check」「掃 LaTeX source」
• 「掃半形標點」「掃缺字」「punct check」「fonts check」
• 直接 /latex-precompile

或 implicit：

• 用戶 batch Edit 多處 .tex 後（commit 前）
• 用戶 import 外部 source（如從 Word 轉的 .tex）

Workflow

Step 1: punct_check — 半形標點偵測

punct_check(source_path)

• source_path 可以是單一 .tex 或目錄（會遞迴掃所有 .tex，自動跳 _archive）
• 偵測 CJK 中間夾雜的半形 ,;:?!()
• 智能判斷：括號只在「前後都是 CJK」時才報警，避免誤報 \foo(x) 這類 LaTeX 語法
• 跳過 $...$ math mode
• 跳過 % 開頭整行 comment

Step 2: fonts_check — 字型缺字（需要 .log）

fonts_check(project_path, main_file?)

• 從 .log 抽 Missing character: There is no X in font Y! warnings
• 自動 dedup（同一字元 + 同一字型只報一次）
• 回傳 unicode 表 + 字型對照

前置條件：必須已編譯過一次（.log 存在）。如果沒，先 call compile_latex 跑一次（缺字字型 fallback 不會 abort 編譯）。

Step 3: box_warnings — overfull/underfull box

box_warnings(project_path, main_file?, severity_min?)

• 從 .log 抽 box warnings
• severity_min 過濾低分（如「10000」只看 badness ≥ 10000）

Step 4: 整理回報

整理三個 check 結果成 audit 報告：

## LaTeX precompile check 報告

### ⚠️ 標點符號（punct_check）
共 N 處：
- 02_暑期班/.../ch04.tex:L432:C18  ',' → '，'  「⋯⋯」
- ...
建議：batch 修這 N 處或跑 autofix_punct.py

### ⚠️ 字型缺字（fonts_check）
共 M 個 unique：
| 字元 | Unicode | 字型 |
|------|---------|------|
| ⋯   | U+22EF  | Times New Roman |
建議：⋯ → \dots / \cdots，→ → $\to$

### ⚠️ box 警告（box_warnings, badness ≥ 10000）
共 K 個：
- Overfull \hbox (15.23pt too wide) at line N
- ⋯
建議：手動檢查指定行，調整 \hyphenpenalty 或加 \\\\ break

跟既有 make check 的關係

如果 project 已有 Makefile 含 check/check-punct/check-fonts target（如 educator 暑期班的 setup），這 skill 提供更 unified 的 audit — 結果可以 cross-reference 既有 script，但不取代它們（script 跑得快，CI 用 script；互動 audit 用 skill）。

注意事項

• fonts_check 需要 .log：如果 .log 不存在會 error。提示用戶先 compile_latex 一次
• punct_check 對 _archive 目錄會自動跳過：但 99_archive 之類不會。如果 user 專案用不同 archive 命名，要明說
• 不要對 ground truth 章節改 source：如 educator 春季班 ch01-03 是 baseline，即使 punct_check 報半形也不該動（typesetting-checklist 規則：春季班源檔不改）